Hi Brynn, Carl + all manual editors, having a glossary at the end of the Beginners' guide sounds like a nice idea. Also makes for a good place to link to, from various places in the book.
Unfortunately, we cannot copy-paste from http://wiki.inkscape.org/wiki/index.php/Inkscape_glossary, to get a quickstart, because of licensing reasons, but we should stick to the terminology that is used there, which is the canonical way to name things for Inkscape. Kind Regards, Maren Am 18.05.2017 um 22:37 schrieb Carl Symons: > On Thu, May 18, 2017 at 11:55 AM, brynn <br...@frii.com> wrote: >> Hi Friends, >> I think Maren mentioned to Carl about terminology (in a different >> message) and I agree that one of the most important things we need to do, is >> use >> the same terminology throughout the manual. However, that said, I'm not sure >> what the best way to accomplish that would be. > > This is an excellent suggestion for high level consistency as well. > >> >> Actually I was going to propose some changes to some of the section >> and >> chapter titles, in this message. But now that I think about it, that might >> be >> putting the cart before the horse (as we say here, sometimes). >> >> Should we create a Glossary? I mean as part of the manual? Or >> should >> we create a glossary that we just use for our own reference, as we write? >> Maybe >> make it part of the wiki? The gitlab wiki? > > Yes, a Glossary would be helpful in the manual. It would be useful as > the manual is written; almost essential when beginners are using > Inkscape. Probably good in a wiki, perhaps after the manual is > complete to maintain consistency. > > >> >> Once or twice I've had a thought about making a glossary for the >> website >> someday. But until the website contains more instructional info, it probably >> has no purpose yet. But what I mean is that creating a glossary, whether >> formally part of the manual, or just in the wiki, could also be used on the >> website someday. > > Yes. > > >> >> If not glossary, what are some other ways we could keep ourselves >> all on >> the same page regarding terminology? What about one person (or 2?) who >> primarily takes care of that? Other ideas? > > It's likely that the people writing have some idea of what any terms > mean. So it would work for people to write using their own terms (for > example, I don't plan to write technical stuff about anything that I > don't understand. So in situations where the material is too advanced > for me, I'll only edit grammar, spelling and clarity, depending on > others who are more knowledgeable to provide the technical details). > Some smart person can come back and make terminology consistent > throughout the manual. I think that would be better than for people to > try to learn proper terminology first. > > This also applies to the style of writing throughout the document. > Several people will be writing--and they should be writing in a way > that is comfortable to them. A final editing task will be to revisit > the document as a whole and make the style consistent. > > > Carl > > >> >> 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
