From 31633c7addf25619a2a3042fc3e27f21aa97a831 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Sat, 17 Oct 2009 14:43:11 +0200 Subject: Add some more reasoning. Split out unrelated issue. --- .../cleaning_up_discussion_pages_and_the_like.mdwn | 11 +++++++++++ doc/forum/ever-growing_list_of_pages.mdwn | 19 +++++++++++++------ 2 files changed, 24 insertions(+), 6 deletions(-) create mode 100644 doc/forum/cleaning_up_discussion_pages_and_the_like.mdwn (limited to 'doc') diff --git a/doc/forum/cleaning_up_discussion_pages_and_the_like.mdwn b/doc/forum/cleaning_up_discussion_pages_and_the_like.mdwn new file mode 100644 index 000000000..35ceae59b --- /dev/null +++ b/doc/forum/cleaning_up_discussion_pages_and_the_like.mdwn @@ -0,0 +1,11 @@ +For example in [[forum/ikiwiki__39__s_notion_of_time]], should one remove the +text about the implementation bug that has been fixed, or should it stay there, +for reference? --[[tschwinge]] + +> I have no problem with cleaning up obsolete stuff in the forum, tips, etc. +> --[[Joey]] + +That's also what I think: such discussions or comments on [[forum]] discussion +pages, or generally on all pages' [[Discussion]] subpages, can be removed if +either they're simply not valid / interesting / ... anymore, or if they've been +used to improve the *real* documentation. --[[tschwinge]] diff --git a/doc/forum/ever-growing_list_of_pages.mdwn b/doc/forum/ever-growing_list_of_pages.mdwn index 435b12c8c..9920e34bb 100644 --- a/doc/forum/ever-growing_list_of_pages.mdwn +++ b/doc/forum/ever-growing_list_of_pages.mdwn @@ -5,10 +5,6 @@ they're still present in the repository. Shouldn't there be some clean-up at some point for those that have been resolved? Or should all of them be kept online forever? -Likewise, for example in [[forum/ikiwiki__39__s_notion_of_time]], should one -remove the text about the implementation bug that has been fixed, or should it -stay there, for reference? - --[[tschwinge]] > To answer a question with a question, what harm does having the done bugs @@ -18,5 +14,16 @@ stay there, for reference? > running older versions of the Ikiwiki software may find the page explaining > that the bug is fixed if they perform a search. -- [[Jon]] -> I like to keep old bugs around. OTOH, I have no problem with cleaning up -> obsolete stuff in the forum, tips, etc. --[[Joey]] +> I like to keep old bugs around. --[[Joey]] + +So, I guess it depends on whether you want to represent the development of the +software (meaning: which bugs are open, which are fixed) *(a)* in a snapshot of +the repository (a checkout; that is, what you see rendered on +), or *(b)* if that information is to be contained in the +backing repository's revision history only. Both approaches are valid. For +people used to using Git for accessing a project's history, *(b)* is what +they're used to, but for those poor souls ;-) that only use a web browser to +access this database, *(a)* is the more useful approach indeed. For me, using +Git, it is a bit of a hindrance, as, when doing a full-text search for a +keyword on a checkout, I'd frequently hit pages that reported a bug, but are +tagged `done` by now. --[[tschwinge]] -- cgit v1.2.3 From f71e84c918827a482158073af45fa7f9acc5ed31 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Sat, 17 Oct 2009 15:00:12 +0200 Subject: Reflect merge of page. --- doc/bugs/broken_parentlinks.mdwn | 2 +- doc/users/tschwinge.mdwn | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/bugs/broken_parentlinks.mdwn b/doc/bugs/broken_parentlinks.mdwn index f8f96b6ca..556d89b65 100644 --- a/doc/bugs/broken_parentlinks.mdwn +++ b/doc/bugs/broken_parentlinks.mdwn @@ -10,7 +10,7 @@ a dead link for every subpage. This is a bug, but fixing it is very tricky. Consider what would happen if example.mdwn were created: example/page.html and the rest of example/* -would need to be updated to change the parentlink from a bare work to a +would need to be updated to change the parentlink from a bare word to a link to the new page. Now if example.mdwn were removed again, they'd need to be updated again. So example/* depends on example. But it's even more tricky, because if example.mdwn is modified, we _don't_ want to rebuild diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 341a52953..3bab61bc1 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -75,7 +75,7 @@ pages could perhaps be passed on to the referred-to page? ## Sendmail -- [[todo/passwordauth:_sendmail_interface]] -## Parentlinks -- [[bugs/non-existing_pages_in_parentlinks]] +## [[bugs/Broken Parentlinks]] ## Discussion Pages of Discussion Pages of... -- cgit v1.2.3 From f51a2b654fbcf6b3b6ae7ad50b2c1929705f2b22 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Sat, 17 Oct 2009 15:16:02 +0200 Subject: [[!map tagged=...]]: Try to tell more clearly what I'd expect. --- doc/users/tschwinge.mdwn | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'doc') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 3bab61bc1..53902a7df 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -48,6 +48,20 @@ contain the \[[!tag open_issue_hurd]]. > `tagged(open_issue_hurd)` in its pagespec should do that. --[[Joey]] +>> Well, that's exactly what this page contains: \[[!map +>> pages="tagged(open_issue_hurd) and !open_issues and !*/discussion" +>> show=title]] +>> +>> This is currently rendered as can be seen on +>> , but I'd imagine +>> it to be rendered by **only** linking to the pages that actually do contain +>> the tag, (**only** the outer leaf ones, which are *capturing stdout and +>> stderr*, *ramdisk*, *syncfs*, ...; but **not** to *hurd*, *debugging*, +>> *translator*, *libstore*, *examples*, ...). Otherwise, the way it's being +>> rendered at the moment, it appears to the reader that *hurd*, *debugging*, +>> *translator*, *libstore*, *examples*, ... were all tagged, too, and not only +>> the outer ones. + ## Anchors -- [[ikiwiki/wikilink/discussion]] ## Default Content for Meta Values -- [[plugins/contrib/default_content_for___42__copyright__42___and___42__license__42__]] -- cgit v1.2.3 From 1859ccf8ace69c7f2db4872b269be10a66b41e4d Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Sat, 17 Oct 2009 15:19:01 +0200 Subject: feedfile: Thanks, Joey, indeed *not* using usedirs was what I meant. --- doc/users/tschwinge.mdwn | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) (limited to 'doc') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 53902a7df..33a139784 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -119,13 +119,10 @@ create a way to modify the `TITLE` template variable suitably. ## [[plugins/inline]] feedfile option Not that important. Git commit b67632cdcdd333cf0a88d03c0f7e6e62921f32c3. This -would be nice to have even when using *usedirs*. Might involve issues as +would be nice to have even when *not* using *usedirs*. Might involve issues as discussed in *N-to-M Mapping of Input and Output Files* on [[plugins/contrib/texinfo]]. -> Do you mean when *not* using usedirs? It is currently supported for usedirs, -> only. --[[Joey]] - ## Unverified -- these may be bugs, but have yet to be verified * ikiwiki doesn't change its internal database when \[[!meta date]] / -- cgit v1.2.3