On Sep 26, 2007, at 9:17 AM, bulia byak wrote:
Can you try to imagine a _regular user_ when writing? The release notes is a document that should be understandable for any user of Inkscape. You write:
Inkscape now supports optional "icc-color(...)" paint components.
What components? Where? What is "paint"? Where am I supposed to add these components and in what form? This is all really confusing for a regular user.
Please try to expand your explanation and make it understandable. If this means adding a short introduction into SVG features, no problem. Always try to take a wider perspective at what you're doing: this helps in programming too, not only in writing documentation.
Yes,
But please try to understand that different people have different writing styles.
I, for example, really work in an iterative manner. I start with a simple form that is almost an outline. Then over time I add to it and fill things out more. I can't sit down and blast things out all at once.
Then again, there is a large factor that most of the UI work needed is not yet done. So I am unable to describe the end-user view of things yet at the moment (since there is no end-user view yet). As those things get in and finalized, the doc will get more to what you like.