We'd certainly welcome some help with the wiki

Robert Brenstein rjb at robelko.com
Sun Jul 8 07:21:26 CDT 2007


>Hi Barry,
>
>I replied in another thread but yes, we'd be very interested in any
>volunteer help, thanks for volunteering! :-)
>
>What we can do is set up access and perhaps a separate list so that editors
>can communicate with each other - we want to maintain consistency throughout
>the documentation.
>
>Likely we should wait until Ruslan gets back - we use dokuwiki and Ive had
>dokuwiki set up before so that its possible to effectively assign specific
>namespace permissions, but I don't know what else has been put into our
>particular brew (that might blow up if I touch it). Right now its split up
>into English, German and Russian, and likely we will add Japanese too.
>
>Best regards,
>
>Lynn Fredricks
>President
>Paradigma Software
>http://www.paradigmasoft.com
>

Lynn, one thing that should be looked at in the documentation is 
versioning. What I refer to is that not all information applies to 
all versions of Valentina. This is sort of an extension of the 
discussion we had about release branching.

When we had PDF-based documentation, we could have kept PDF file 
specific to each release. However, this is not possible with 
online-only documentation. This will become more and more of a 
problem as Valentina matures and more different versions are being 
used in parallel.

Documentation should at very least indicate in which version a given 
feature or function was introduced, changed, or deprecated. MySQL has 
a separate branch in their docs wiki for each major release, but that 
may be an overkill for Valentina.

Robert Brenstein


More information about the Valentina mailing list