[Freeipa-devel] Wiki: automatic bookkeeping of Design documents

[Petr Vobornik]

On 05/06/2015 08:47 AM, Martin Kosek wrote:
> Hello all,
>
> Knowing the sorrow and unmaintained state of the pages collecting links to our
> designs [1][2], I think we need to execute the second half of my evil plan for
> Design Document management.
>
> We have the Feature design box (see top right corner, e.g. in [3]), so we can
> easily automatically generate mediawiki categories. The first I implemented in
> the template are "FreeIPA $VERSION Design" when target version is filled (and
> design is thus accepted for a release) and "FreeIPA Design Proposal" for
> others. We can be creative with other categories in future, if needed.
>
> But even these 2 and a DynamicPageList plugin allowed me to create
> automatically generated design lists, in [4]. I had to update the box in many
> designs, however.
>
> Makes sense? If yes, I would update these pages. Of course, this requires
> developers to maintain the Feature box properly, but I think it's worth it.

I like it.

What do you think about keeping design proposals on the same page with 
approved designs as is now in [4]? When I'm looking for some design, it 
often happens that I'm not sure on which page it is. With both lists on 
the same page, one could do simple search to find the design quickly.

>
>
> [1] http://www.freeipa.org/page/V4_Proposals
> [2] http://www.freeipa.org/page/V4_Designs
> [3] http://www.freeipa.org/page/V4/User_Certificates
> [4] http://www.freeipa.org/page/Talk:V4_Designs
>
-- 
Petr Vobornik