Re: docs Digest, Vol 98, Issue 3

Send docs mailing list submissions to docs(a)lists.fedoraproject.org To subscribe or unsubscribe via the World Wide Web, visit https://admin.fedoraproject.org/mailman/listinfo/docs or, via email, send a message with subject or body 'help' to docs-request(a)lists.fedoraproject.org You can reach the person managing the list at docs-owner(a)lists.fedoraproject.org When replying, please edit your Subject line so it is more specific than "Re: Contents of docs digest..." Today's Topics: 1. Open Help Conference (Shaun McCance) 2. Screenshots in User Guide (Romain Forlot) 3. Re: Screenshots in User Guide (Ben Cotton) 4. Re: Screenshots in User Guide (Craig Edgmon) 5. Re: Screenshots in User Guide (Craig Edgmon) ---------------------------------------------------------------------- Message: 1 Date: Thu, 05 Apr 2012 10:50:14 -0400 From: Shaun McCance <shaunm(a)gnome.org&gt; To: docs(a)lists.fedoraproject.org Subject: Open Help Conference Message-ID: <1333637414.2136.518.camel@recto> Content-Type: text/plain; charset="UTF-8" Hi folks, I'm hosting the Open Help Conference & Sprints again this year, August 11-15. I know a lot of Fedora people were interested last year, but nobody was able to make it. I hope to see some friendly Fedora faces this year. http://openhelpconference.com/ The main conference is August 11-12. This is followed by multiple team sprints August 13-15. I'd love to see a Fedora sprint, and perhaps have a Fedora/GNOME meetup to see how we can better help each other. The presentation proposal period is now open, so if you'd like to share something cool with the world, let me know. Also, this year I'm having a tools showcase, a set of lightning talks where we all show off the tools we make and use. If you have any questions, just email. Thanks, Shaun ------------------------------ Message: 2 Date: Thu, 5 Apr 2012 23:27:05 +0200 From: Romain Forlot <rforlot(a)yahoo.com&gt; To: For participants of the Documentation Project <docs(a)lists.fedoraproject.org&gt; Subject: Screenshots in User Guide Message-ID: <CABm5gs7AVYAAgisc4sR1K-brn+Lyp765T7Vw5MvEZMZOJn8Q_Q(a)mail.gmail.com > Content-Type: text/plain; charset=ISO-8859-1 Hi, I just wrote about Custumizing Desktop for User Guide and I see that the Gnome part use screenshots but to write kde part I didn't take screenshots.I think, it imbalance the page contents. So it is all right like that ? Do I need to take screenshots or remove existing ? I hesitate. Regards. -- *Romain Forlot* pub 4096R/862907E5 2011-05-26 Key fingerprint = 4549 A7CA 17DC D0AA 0FE0 7953 E6A8 A0C8 8629 07E5 uid Romain Forlot <rforlot(a)yahoo.com&gt; sub 4096R/153E34C2 2011-05-26 ------------------------------ Message: 3 Date: Thu, 5 Apr 2012 17:55:54 -0400 From: Ben Cotton <bcotton(a)fedoraproject.org&gt; To: For participants of the Documentation Project <docs(a)lists.fedoraproject.org&gt; Subject: Re: Screenshots in User Guide Message-ID: <CAMhUM_U4rQfJe10idK6qVgiNk5JdCog1aY0YZVjbdJYJHdQF8Q(a)mail.gmail.com > Content-Type: text/plain; charset=ISO-8859-1 Generally, it's best to omit screenshots unless they contribute significantly to understanding. Images aren't easily translated, so for documents in !en-US either the image doesn't have the correct language or the translator has to produce a new image. If the content can be expressed clearly in text only, I'd suggest removing or at least reducing the Gnome images. Anyone else have thoughts on this? -- Ben Cotton Fedora Docs Leader ------------------------------ Message: 4 Date: Thu, 05 Apr 2012 15:58:16 -0600 (MDT) From: Craig Edgmon <cedgmon(a)shaw.ca&gt; To: For participants of the Documentation Project <docs(a)lists.fedoraproject.org&gt; Cc: For participants of the Documentation Project <docs(a)lists.fedoraproject.org&gt; Subject: Re: Screenshots in User Guide Message-ID: <26368D7F-802D-4C16-9AA7-D5630449886D(a)shaw.ca&gt; Content-Type: text/plain; charset=us-ascii I agree. In addition screen captures have a tendency to go out of date too fast. Thank you, Craig Edgmon Application Specialist On 2012-04-05, at 14:56, Ben Cotton <bcotton(a)fedoraproject.org&gt; wrote: > Generally, it's best to omit screenshots unless they contribute > significantly to understanding. Images aren't easily translated, so > for documents in !en-US either the image doesn't have the correct > language or the translator has to produce a new image. > > If the content can be expressed clearly in text only, I'd suggest > removing or at least reducing the Gnome images. Anyone else have > thoughts on this? > > > -- > Ben Cotton > Fedora Docs Leader > -- > docs mailing list > docs(a)lists.fedoraproject.org > To unsubscribe: > https://admin.fedoraproject.org/mailman/listinfo/docs ------------------------------ Message: 5 Date: Thu, 05 Apr 2012 16:01:21 -0600 (MDT) From: Craig Edgmon <cedgmon(a)shaw.ca&gt; To: For participants of the Documentation Project <docs(a)lists.fedoraproject.org&gt; Cc: For participants of the Documentation Project <docs(a)lists.fedoraproject.org&gt; Subject: Re: Screenshots in User Guide Message-ID: <CFA4230E-FA7C-40BF-A22D-3779EA65A4AD(a)shaw.ca&gt; Content-Type: text/plain; charset=us-ascii Sorry one more comment. Unless they are professionally edit, it may cause the experience to be cheapened and increase the size of any document. It is easier to search and replace than rip and replace. Thank you, Craig Edgmon Application Specialist On 2012-04-05, at 14:56, Ben Cotton <bcotton(a)fedoraproject.org&gt; wrote: > Generally, it's best to omit screenshots unless they contribute > significantly to understanding. Images aren't easily translated, so > for documents in !en-US either the image doesn't have the correct > language or the translator has to produce a new image. > > If the content can be expressed clearly in text only, I'd suggest > removing or at least reducing the Gnome images. Anyone else have > thoughts on this? > > > -- > Ben Cotton > Fedora Docs Leader > -- > docs mailing list > docs(a)lists.fedoraproject.org > To unsubscribe: > https://admin.fedoraproject.org/mailman/listinfo/docs ------------------------------ -- docs mailing list docs(a)lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/docs End of docs Digest, Vol 98, Issue 3 ***********************************