Re: FAQ Update

On Wed, Aug 20, 2008 at 7:47 PM, Alex Rousskov
<rousskov_at_measurement-factory.com> wrote:
>
> On Wed, 2008-08-20 at 10:07 +0200, Kinkie wrote:
>> On Wed, Aug 20, 2008 at 5:40 AM, Amos Jeffries <squid3_at_treenet.co.nz> wrote:
>> > So far this is only a 1 minute chat between Adrian and myself, but I think
>> > its worthwhile doing and we all need to discuss at least.
>> >
>> > Issue: theres a lot of obsolete text in the FAQ.
>> >
>> > Adrians (probably joking): 'chuck it and start again'.
>> > Amos: 'no, chuck everything only relevant for 2.5 and earlier, re-evaluate
>> > based on whats left'
>>
>> I'd go for the latter: the FAQ is _huge_.
>
> Folks are still using 2.5 so we should at least archive the old FAQ if
> things get deleted. Deleting the whole thing is not a good option, IMO,
> but it is a lot of work to review and cleanup each item.
>
> Perhaps we can have two indexes into the same FAQ: one index links to
> reviewed and reasonable accurate/fresh entries only. The other links to
> all (or other?) entries. Both can be built automatically if we add a tag
> to fresh/reviewed FAQ entries.

THE Solution to this (capital S) is to split the wiki into its
individual entries, to be tagged in various ways and assembled
as-needed. Unfortunatley this requires the wiki engine to be extended
to support metadata. There are a few threads going on in the MoinMoin
dev community on how to achieve this, but at this time there's nothing
relly useful in terms of code.
I can try to come up with something which could at least solve our
problem (a first attempt was the ForEach macro, which however has
issues of its own)

-- 
 /kinkie