17 Aug
2009
17 Aug
'09
11:21 a.m.
Vincent Massol wrote:
Hi,
As you know I like clean stuff (some could call it an obsession ;)).
While browsing the Design/Idea spaces on dev.xwiki.org I noticed
several pages containing stuff already implemented.
I'd like to propose the following strategy:
* Once a design has been implemented, document it (for example in the
Modules space on code.xwiki.org)
* When both the new design has been implemented and documented, delete
the wiki page in the Design space.
Shouldn't we keep those for historical reasons, somewhere outside the
Design space? How about DesignArchive? We could move a page there, and
add at the end or at the top a conclusion, like "Implemented, see [the
documentation page]", or "Deprecated, see [alternative design]".
For example I'd like to remove this page:
http://dev.xwiki.org/xwiki/bin/view/Design/XWikiSyntaxMapping
I'd also like to document the xwiki-component module in Modules and
then remove this page:
http://dev.xwiki.org/xwiki/bin/view/Design/ArchitectureV2
This one should be kept IMO, since it contains more than just the
description of the component architecture.
--
Sergiu Dumitriu
http://purl.org/net/sergiu/