17 Aug
2009
17 Aug
'09
3:21 p.m.
On Aug 17, 2009, at 11:21 AM, Sergiu Dumitriu wrote:
Then this additional stuff needs to be documented properly somewhere
IMO.
Thanks for the feedback
-Vincent
Vincent Massol wrote:
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.
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.