Sounds good to me. I'd go with whatever Maren wants to do. Truly, I'm good with anything. I do think that the screenshots should be platform agnostic. There isn't really a need to include window decoration, and I think it distract from the application graphics. I'll go about filling in some more recent and better screen captures once the cover and Hackfest items are complete. I would avoid an official release date mentioned because there is just so much to do at this point in the way of formatting etc. But if Maren wants an initial release before Hackfest, go with it. I consider her the project lead for obvious reasons. :)
On 6 Jun 2017 6:42 p.m., "brynn" <brynn@...3133...> wrote:
I've just saved the first draft.
Should we hazard to give an ETA for release? End of the year sounds about right to me, assuming we can get the right kind of people to do all the chores. Or just leave it out?
Now as I'm writing this, I'm curious about how future editing will work. I understand that would be done through the Floss Manuals interface. But if editing can happen at any time, then can the book be re-published at any time? Or would we always be telling users to see the FM version for the most up to date info, while re-publishing would happen less frequently?
Should we also post this in forums? Or maybe abbreviated version of it?
I left out the cover designing, since C R is already working on that. I also left out the last type of helpers (putting the screenshots and graphics in their proper places) because I've been planning to do that. Although it seems like whoever is creating the screenshots and graphics would already know where they're supposed to go. Right?
All best, brynn
-----Original Message----- From: Maren Hachmann Sent: Sunday, June 04, 2017 4:55 PM To: Inkscape Devel List Subject: Re: [Inkscape-devel] [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-devel mailing list Inkscape-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/inkscape-devel
Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot _______________________________________________ Inkscape-devel mailing list Inkscape-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/inkscape-devel