Valentina documentation

[Robert Brenstein]

I just looked more thoroughly at Valentina's documentation, trying to 
follow up on the new V2 features. It strikes me that the kernel 
document is heavily using C++ or RB syntax when explaining different 
things.

I wonder whether it would not be a good time for Paradigma to 
reshuffle the structure of documentation: make kernel doc more of a 
technology overview, focusing on general features, capabilities, 
restrictions, whereas moving all the  implementation aspects to 
guides for specific products, so they can be presented and discussed 
using the syntax and examples appropriate for each environment.

I do realize that this would mean greater duplication of some things 
than now, but I think it would be a great benefit to users, both old 
and new. It would allow Paradigma to better utilitze the feedback 
from the lists and may be (on the long term) get other people to 
contribute to the documentation. It would also help tracking 
documentation issues in Mantis.

Robert Brenstein