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

_______________________________________________
devs mailing list
devs@xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs

Reply via email to