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

[Martin Kosek]

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.


[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

-- 
Martin Kosek <mkosek at redhat.com>
Supervisor, Software Engineering - Identity Management Team
Red Hat Inc.