On Aug 17, 2009, at 11:21 AM, Sergiu Dumitriu wrote:
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]".
I understand your point, which is to not loose the "discussion" that produced the designs, including comments from people, etc. BTW we already have a "Completed" state in Design. However you don't see it when you browse the design space using XEclipse or WebDAV so at the very minimum moving them out in a DesignArchive space would help. Ok I'll move them there for now even though the likelihood that we'll need them is probably low.
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.
Then this additional stuff needs to be documented properly somewhere IMO. Thanks for the feedback -Vincent