I thought I posted that I had a first draft, but now I can't find it. So this
is it: https://inkscape.org/en/news/unpublished/812/
Let me know if any changes are needed, or if it can be published as is. Or for
those who have access, please feel free to make changes and/or publish it
yourself :-)
All best,
brynn
-----Original Message-----
From: Maren Hachmann
Sent: Tuesday, June 06, 2017 3:42 PM
To: brynn ; inkscape-docs@lists.sourceforge.net
Subject: Re: [Inkscape-docs] News item about the new manual work?
Am 06.06.2017 um 14:29 schrieb brynn:
Hi Maren,
Oh yes, that's awesome content, and great ideas! I'll be able to
get that done today!
Yes, a "getting unstuck" or "faq" or "troubleshooting" section
would be great! It will be a little while before I start on that. But
it's on my to-do list.
(Looks like I started up a mess, with my recent request to fix
one of those type of items via developers! Meaning the draw first,
style 2nd debate, which is nothing to do with what I wanted. But oh
well, it's progress.)
I'll post when I have a draft ready.
- Great, thank you!
Be sure to post a link, when you are ready for proofing.
Kind Regards,
Maren
All best,
brynn
-----Original Message----- From: Maren Hachmann
Sent: Sunday, June 04, 2017 4:54 PM
To: inkscape-docs@lists.sourceforge.net
Subject: Re: [Inkscape-docs] News item about the new manual work?
Hi Brynn,
yes, a short news item would be nice to show that work has started on a
Beginners' Guide (it's not a real manual, in the classical sense).
I think we especially need:
- a few (not so many!) testers who only begin using Inkscape, to tell us
if they understand it. They can accompany us, but also join at a later
point of time. This could also be a teacher, who has experience teaching
Inkscape to students.
- one or two artists who want to design a cover image for the various
output formats. This artist needs to be able to find his way around in
the booktype interface, and to be able to follow the manual instructions
about the interface. Also needs to remember to indicate a separate
licence for the cover image - it needs to be CC-By-SA, with the Inkscape
icon in it.
- one to three web designers who can take a closer look into the
Booktype CSS options, find out what is possible, and make an Inkscape-y
design for the html version of the book, and perhaps also style the pdf.
I think epub doesn't have too many styling options available (but I may
be wrong).
- 2 or 3 quality assurance people, who can check for consistency of
terms used, html tags used for specific concepts (e.g. keyboard
shortcut, menu entry, position of tool icons, ...) etc. throughout the
book.
- one or two persons who team up to make consistent screenshots with
default icon set and English interface (if possible, on Windows, as most
users will be on that platform). One could make the example svgs (or ask
Elisa for them) and the other could make the screenshots and upload them.
- one or two persons who move the pictures around when they are in, so
they are all in their appropriate position in relation to the text.
I think we do have enough native speakers now who can fix strange
wording :)
Feel free to cut off the parts that don't appear useful in an article.
Much of this was meant as an explanation for you.
As for later work, what do you think about this?
We can add a 'Getting unstuck' section, perhaps, with hints on what to
do when one gets a result one does not expect - which can cover the
whole range from 'look into status line' to frequent issues to 'ask in
forums' to 'post a bug report'.
I think you would be the one who is best suited to compile a list of
frequent noob issues with solutions that could be addressed here. If you
would like to do that, you can take your time, I know you've got a lot
of other tasks to address at the moment.
Kind Regards,
Maren
Am 04.06.2017 um 13:17 schrieb brynn:
Hi Friends,
As I'm writing up a quick draft to announce the upcoming
hackfest, I suddenly wondered if it might be a good idea to write a
short item about the recent new work on the new manual?
I could do that, after I finish the hackfest article. I'm
thinking Maren might be able to get all the details correct, the first
time around? Although I don't mean to volunteer her. As I said, I could
do it myself, if we decide to do it.
I think it would help in community-building, to keep the wider
community up to date about these things. What do other manual workers
and Docs list subscribers think?
All best,
brynn
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Inkscape-docs mailing list
Inkscape-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/inkscape-docs
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Inkscape-docs mailing list
Inkscape-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/inkscape-docs
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Inkscape-docs mailing list
Inkscape-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/inkscape-docs
