Re: [Inkscape-docs] News item...manual...first draft ready
I'll have a look again later today, first I'll need to get the README on gitlab ready, then I'll make the edits to include a link. I found a previous version of the news article yesterday and liked it a lot :) Thank you, Brynn, for working on this so quickly and phrasing it so nicely! Kind Regards, Maren Am 07.06.2017 um 14:14 schrieb brynn: > 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,
Re: [Inkscape-docs] Fwd: Re: [Inkscape-devel] News item about the new manual work?
We're working on getting set up on gitlab already. I'll post an invitation shortly, stay tuned :) Kind Regards, Maren Am 07.06.2017 um 14:08 schrieb brynn: > I'm not sure if this was answered. So just in case, and apologies if > I'm duplicating an answer. > > Most mail programs have a Reply button, Reply All button and Forward > button. So I almost always us Reply All on a mailing list. That makes > sure that the reply goes to everyone which the original was sent to (if > there were more than 1 original recipient). > > Maybe that would help, if your email program offers it? > > All best, > brynn > > -Original Message- From: Marietta Walker > Sent: Tuesday, June 06, 2017 3:47 PM > To: inkscape-docs@lists.sourceforge.net > Subject: [Inkscape-docs] Fwd: Re: [Inkscape-devel] News item about the > new manual work? > > > > And I am the culprit on not getting sending back to the list. My email > defaults to the sender not the list and I keep forgetting to change the > email address and I just did it to Maren with the messages below! > > Shame on me > > Marietta > > > > > Forwarded Message Subject: Re: [Inkscape-docs] > [Inkscape-devel] News item about the new manual work? Date: Tue, 6 Jun > 2017 16:36:12 -0500 From: Marietta Walker > mailto:marie...@loghomenet.us To: Maren Hachmann > mailto:ma...@goos-habermann.de > > No problem at all. I did take a look, and you will find I am pretty > flexible, but is OK to use the English board? I am sure I will not learn > French in time to help with anything! I will be happy to extract and > help track task and mark them complete as we go. And as a new user of > Inkscape, you can count on me to also test as we go. Regards Marietta On > 6/6/2017 4:09 PM, Maren Hachmann wrote: > Hi Marietta, > > a kanban > board is a good idea, but there are free alternatives which I > would > prefer to see used, e.g. https://framaboard.org/. > > Perhaps you would > be willing to extract the tasks from previous messages > (esp. the one > about the news item to Brynn) and move the board over to > framaboard? > Also, we would need someone to take care of marking tasks > that are > done by people who are not registered there as done. > > We don't need > everyone to have an account, I think - we could also just > add their > names, when we know they want to work on it. > > What do you think, > Marietta? > > Kind Regards, > Maren > > Am 06.06.2017 um 20:45 schrieb > brynn: >> No thanks for me. (I've already got a whole notebook of login >>> passwords.) But I think Martin has been looking for something like >> > that. Especially if it would give automatic reminders (afaiu). >> >> All > best, >> brynn >> >> -Original Message- From: Marietta Walker >> > Sent: Monday, June 05, 2017 9:59 AM >> To: > inkscape-docs@lists.sourceforge.net >> Subject: Re: [Inkscape-docs] > [Inkscape-devel] News item about the new >> manual work? >> >> Hi all, >>> >> I have set myself up with Trello in order to track notes and > completion >> of Chapter review.. (Just to let everyone know I will not > be actually >> editing chapters, only providing feedback to Maren on > those things I >> need to. ) >> >> I digress. Trello is free and easy to > use. It has taken me about ten >> minutes to figure it out and set my > self up with a checklist, which I am >> now working on breaking into > Sub-heading groups. >> >> With that said, if anyone would like to join > me there to create >> checklists /progress tracking, If everyone jumped > in to use, we could >> also let the group know where we are because I > have made it public for >> viewing. >> >> So if you want to check it > out-here is the link. >> https://trello.com/b/5MTvCikC/inkscape >> >> If > you want to use it, then create an account and then send me your info. >>> >> Regards >> Marietta >> >> On 6/4/2017 6:10 PM, Marietta Walker > wrote: >>> I think it will suit me perfectly. >>> >>> Thanks--Marietta >>> On 6/4/2017 5:55 PM, Maren Hachmann wrote: Thank you, > Marietta, Carl, and Martin for pointing me into the right direction > (hopefully) and for calling for help, and volunteering your time :) > I'm glad to know that people are still interested in helping, > but might just not have known how (or, in CR's case, are too busy > with other stuff - believe me, I understand). Guess I got too > used to the standard open source theme of 'grab a task and do it if > you're up to it' - and I'm also kind of shy about telling others > what to do. I'm sorry about not getting that I should take on a > more active, guiding role, to make it easier for new members to join. > @Marietta: What do you think about Martin's suggestion? > Kind Regards, Maren Am 04.06.2017 um 22:52 > schrieb Martin Owens: > On Sun, 2017-06-04 at 13:20 -0500, Marietta > Walker wrote: >> If I can help, I will be glad to do so, but I do > have
Re: [Inkscape-docs] News item.... graphics issues in manual
Hi Marietta, I now have master permissions on the linked project, and have added you as a developer there. Also assigned you to your first task :) You don't need SSH to just work on the issues section. We will not use the repository for anything but the README file currently. Translations are far in the future, let's start with the task at hand. Try to keep the overhead small (short issue texts, concise descriptions). If you like, you can create an issue for 'We need to figure out how translations of the manual can be created and tracked' (proposed solution: just make a copy of the book on flossmanuals, then translate, organize translators via issue on gitlab, use issue tags to specify language.). Kind Regards, Maren Am 07.06.2017 um 06:41 schrieb Marietta Walker: > For Martin: > > Are we working on the project at Gitlab titled: > Inkscape\Inkscape-docs\manuals or are you creating another project? If > we keep it under one large generic heading such as the above mentioned, > then we can track sub projects under one umbrella, English Translation > for Inkscape Beginners/Dutch Translation for "Whatever/etc. Am I making > any sense? > > Also do I need to add SSH to my account? > > Since I am completely unfamiliar with Gitlab, I am wanting to get in > there and learn and get started. > > Thanks > > > > > On 6/6/2017 10:15 PM, brynn wrote: >>> - We will delete some, and keep those that are good. If you don't want >> to work on this, then we can add this to the task list, for someone else >> to grab. >> >> No, I don't mind doing it. I just need to be clear what the goal is >> and what the parameters are. Although I won't be happy if I rename >> files and find out later that they're going to be replaced. >> >> Here you seem to be asking me to make the screenshots. But in a >> different message, I thought you said that CR had volunteered. Maybe I >> misunderstood somewhere? But I don't have a very pretty theme color. >> >> How about if I make a list of all the ones that need to be replaced, >> and give the list to C R. Then he could make them with the default >> Windows theme, and either upload them himself, or send to me and I'll >> upload? >> >> Not sure about developers spending time reviewing the manual at >> hackfest, when time is at such a premium, with travel expenses and >> all. It seems like after hackfest would be better. Plus do we really >> need reviews from advanced users? New users would seem better for >> sources of reviews? >> >> But I can finish my part before hackfest. If C R has time to make >> them, I'm sure we can finish the whole thing by that time. Or even if >> you want me to try making another user account, to find out if it >> could use a different theme. Then I could make the screenshots. >> >> All best, >> brynn >> >> >> -Original Message- From: Maren Hachmann >> Sent: Tuesday, June 06, 2017 7:50 PM >> To: brynn ; Inkscape-Docs >> Subject: Re: [Inkscape-docs]News item graphics issues in manual >> >> Am 07.06.2017 um 03:08 schrieb brynn: >>> If you're saying that Inkscape is supposed to detect what kind of screen >>> is being used, and automatically set itself accordingly, that's >>> something I've never heard of, or experienced. >> >> - According to the program code, if width/height > 1.65, Inkscape will >> switch to 'Wide' mode. You could try it out by removing / renaming your >> preferences file. I suspect you have moved it from your old computer. >> Let's stick to that for screenshots, it makes sense. If it doesn't work, >> it's a bug. >> It would be helpful if you could continue with renaming the images that >>> do not need to be changed - i.e. the tool icons, or drawings without any >>> text or menus shown. >>> >>> I haven't started yet. I don't want to duplicate or waste work energy. >>> It seems like it would be less work all around, to just give appropriate >>> names to the new screens and graphics, than to rename them all now, and >>> upload whole new images to relace them later. Or am I missing something >>> about the plans and processes? >> >> - We will delete some, and keep those that are good. If you don't want >> to work on this, then we can add this to the task list, for someone else >> to grab. Can you go through the images, and rename all the files that will not be >>> deleted, so they will be understandable when others look at them at >>> Hackfest time? >>> >>> Wouldn't I need to work with C R (or whoever), to determine which are >>> kept and which are replaced? It seems like some level of coordination >>> and communication should happen for this, rather than 2 different people >>> going at it separately in different ways, possibly making incompatible >>> decisions? >> >> - CR is there for talking, but I trust that you can figure out if an >> image is just a tool icon, or contains a drawing without text, and does >> not need to be re-created. You might even use gimp to cut off some >> French text. This would
Re: [Inkscape-docs] News item...manual...first draft ready
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
