From 31633c7addf25619a2a3042fc3e27f21aa97a831 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Sat, 17 Oct 2009 14:43:11 +0200 Subject: [PATCH] Add some more reasoning. Split out unrelated issue. --- ...ning_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 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]]