Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 28 May 2008 00:19:16 +0300
From:      Manolis Kiagias <sonicy@otenet.gr>
To:        Hiroki Sato <hrs@FreeBSD.org>
Cc:        freebsd-doc@FreeBSD.org
Subject:   Re: Wiki style FAQ proposal
Message-ID:  <483C7AD4.5090409@otenet.gr>
In-Reply-To: <20080528.060009.127260270.hrs@allbsd.org>
References:  <483B3E98.6040804@otenet.gr>	<483B92D1.4040500@FreeBSD.org>	<483C6E04.3070804@otenet.gr> <20080528.060009.127260270.hrs@allbsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help


Hiroki Sato wrote:
> Manolis Kiagias <sonicy@otenet.gr> wrote
>   in <483C6E04.3070804@otenet.gr>:
>
> so> - Create a wiki style FAQ (while still maintaining the current version of the FAQ) with a possible future plan to limit the original SGML FAQ to questions related to the way the Project works, rather than technical stuff.
> so> - Maintain the current FAQ as is, and also create a wiki that will serve for the most up-to-date technical questions. Periodically, these could also be used to update the SGML version of the FAQ, or (if possible) the wiki could be converted in a way to static content so it becomes re-distributable.
> so>
> so> We believe experimenting with  a wiki style FAQ (regardless of what is decided about the SGML FAQ) is a good idea, since more people will be able to get involved and the information will be much more current and useful. We also realize there maybe several drawbacks to it: 1) Not really distributable (as mentioned above) 2) Good administration will be needed so the organization of categories and content does not become 'chaotic'
> so>
> so> In the light of the above, we would like to hear the community's and the committers' ideas and proposals on the above plans.
>
>  I agree that the current FAQ in SGML includes too much stale
>  information and maintaining it is hard, and we definitely need a way
>  to improve it.  My thought is the following:
>
>  - As you pointed out maintaining wiki as a good shape is time
>    consuming than many expected.  Using wiki as a working place is not
>    bad, but I am not for using it as the primary place which holds the
>    FAQ.
>
>  - For making maintenance of the current FAQ easier, the following
>    would be effective I think:
>
>    a) Separate the current SGML source file into small SGML/XML files
>       based on category.  Also, we may need to add more "category tag"
>       (something used in a blog entry, for example) to categorize each
>       item flexibly.
>
>    b) Add "age after the last review" for each item to make it
>       possible to review too old information later.  Periodic review
>       should be scheduled in a way like "all items have to be younger
>       than 1 year old".  SGML/XML framework can handle this sort of
>       information processing easily.
>
>    c) Add a capability of keeping view count of each item if possible.
>       We need to know which item is most frequently referred.
>
>  Do you have more specific idea for using wiki for drafting work of
>  FAQ entries?  I think there is no problem if we maintain the static
>  content and the wiki can encourage people to update.
>
> --
> | Hiroki SATO
>   

Gabor Pali actually had the nice idea that the wiki could have two 
areas, like a "CURRENT" and "STABLE" branch. More people could 
contribute in the current branch, and then the maintainer(s) could move 
what would be considered more valuable content to the 'stable' branch. 
This would also mean there is enough quality control and the whole thing 
does not become disorganized.
I don't  have  any specific technical solution in mind for transferring 
content from the wiki to the sgml FAQ. I suppose we could have some 
maintainers that would periodically check what changed in the 'stable' 
version and update the static FAQ. Decision of what should go in the 
static FAQ could be based on several factors. If you ask me, I would 
consider best to not include very fast changing information in the 
static FAQ. I would, for example, leave the entries that deal with very 
specific hardware troubleshooting (i.e. machine foo will not load 
FreeBSD 6.X) to the wiki, as these get outdated fast as hardware becomes 
obsolete.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?483C7AD4.5090409>