On Tue, Dec 15, 2009 at 10:35, Vincent Massol <[email protected]> wrote:
> Hi,
>
> We need to decide how we want to document xwiki.org with regards to
> project versions and skins. For example the screenshot and features
> described can depend on 2 factors:
> - the project version (XE version for ex)
> - the skin used
>
> Project versions
> =============
>
> We have several choices:
> 1) We make the doc only for the latest version and in this case we
> should probably export the pages at release time and make it available
> as a zipped HTML export so that people using the older version can
> refer to them.
> 2) We make the doc work the last 2 releases. That would be either 2.1
> and 2.0.5 or 2.2M1 and 2.1 depending on how we view it and depending
> on whether we want to document on xwiki.org before we release or not.
>
> Personally I think I prefer option 1 with a little addition:
> - whenever something that is new to the last release is documented, we
> should add a little "New" logo (possibly with the version value, "New
> in 2.2" for example). This could be done with a wiki macro.
>
>
I think that the things we mention in the release notes should be also found
in the features documentation pages.
The feature should state in its page that can be found/works in 2.x version.
It can have an improvements part of the documentation with all the latest
additions and the version that the addition can be found in. This is when
the improvement doesn't completely change the functionality.
I think the documentation should reflect the branches we support and archive
when we support no more.
Ex.
Application X - since XWiki 2.0,
- Colibri, Toucan compatible
....
Improvement X.x - since XWiki 2.1
Also I think we should specify in the applications pages from
code.xwiki.orgwhich is the version they were build on. There we can
make something like
Firefox add-ons: Works with, Updated, Developers, Downloads.
> If option 1 is chosen then we need to add a step to the release process.
>
> Skins
> ====
>
> Again we have several choices:
> 1) Document only for the latest skin
> 2) Document for all supported skins. Right now that would be Toucan +
> Colibri (not sure about Albatross, I don't think we've officially said
> it wasn't supported).
>
> If we were to do 2) then this that for example this page
> http://code.xwiki.org/xwiki/bin/view/Applications/WatchlistApplication
> would need to contain screenshots for all supported skins *OR* there
> should be different screenshots only when the skins have different
> features. This is the case here since the location of menus and
> actions are quite different.
>
> I'm hesitating more for this one...
> 1) is definitely easier for us so I'm tempted to propose 1) but with
> the proviso that we make it clear in the text when a feature is
> available only for a given skin (for ex: the Show Code menu action is
> avail in Colibri but not in Toucan).
>
>
Theoretically, if you don't document a skin, then we are not supporting it.
I think, just like with the version, the feature needs to specify with what
skin its working. If it has the same behavior for both skins, put
screenshots of the latest skin (the one that will be supported longer).
> WDYT?
>
> When we agree we should put the result on dev.xwiki.org in a new page
> describing how xwiki.org is documented.
>
> Thanks
> -Vincent
>
>
>
> _______________________________________________
> devs mailing list
> [email protected]
> http://lists.xwiki.org/mailman/listinfo/devs
>
_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs
