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

Martin Kosek mkosek at redhat.com
Fri May 15 11:32:40 UTC 2015


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.
>
>
> [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
>

Thanks everyone for commenting. Seeing the positive feedback, I did the changes 
and updated the Code Contribution policy and the pages themselves:

http://www.freeipa.org/page/Contribute/Code
http://www.freeipa.org/page/V4_Designs
http://www.freeipa.org/page/V4_Proposals

Enjoy!
Martin




More information about the Freeipa-devel mailing list