John,

Good to have you here :)

For you (and Chris, if he's signed up here, and anyone else who might be working on the EN Inkscape manual at FM), I have been going through the manual of late and marking chapters as needing to be proofed which need the most help. They need help both grammatically and stylistically (with no offense intended to the original authors, several of whom are native French speakers :) as well as content-wise. Though most of the important content is there, it could stand to be reorganised and presented in a more meaningful manner, recalling that much of it was written in haste during the sprint.

Some things I've noticed and I think most need to be fixed:

redundancy complicated or obscure explanations incomplete explanations redundancy profuse wordiness in some places small grammatical errors (especially uses of articles) redundancy

hmm...did I mention that the text tends to repeat itself sometimes? (I think I've weeded most of that out, but I know there's still some left).

A few basic rules will be found at the Agreed conventions for writing this manual http://en.flossmanuals.net/bin/view/Inkscape/WritingConventions link at the top of the page (ask if you have questions - I plan on improving and correcting the guide when I can). The main thing to mention is the text styles we use for ui elements: go ahead and use the styles described in the conventions, don't worry about the nifty div box styling, as these are being either obsoleted or transformed into something different. We are still working that out.

That's enough for now, or I'd continue all day :)

JF

John & Melonie Curwood wrote:

Hi, my names John and I've just joined Joshua Facemyer in working on the Floss Manuals - Inkscape Manual. Joshua has also sugested that I sign up to this list and introduce myself. Um.. that's about it, If you have any questions you would like to ask about me thats cool and I'll probably sending in some questions myself as I start working on the documentation.

Cheers,

John Curwood

---

Open Source Business Conference (OSBC), March 24-25, 2009, San Francisco, CA -OSBC tackles the biggest issue in open source: Open Sourcing the Enterprise -Strategies to boost innovation and cut costs with open source participation -Receive a $600 discount off the registration fee with the source code: SFAD http://p.sf.net/sfu/XcvMzF8H _______________________________________________ Inkscape-docs mailing list Inkscape-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/inkscape-docs