Re: Documentation Video Proposal



Hi Bastian,
 
 
On Mon, Apr 28, 2014, at 12:54 PM, Bastian Hougaard wrote:
Hi gnome-doc-list,
 
I am working on a video proposal for a video about the documentation we provide in GNOME. The goal is to increase awareness of GNOME's documentation efforts and what uses it has. The video will be in similar style to the release video, except shorter, working as a spotlight video. I plan to cover Help for users, the Developer Center and the Sysadmin Guide. A manuscript for the video can be found below:
 
https://wiki.gnome.org/BastianIls%C3%B8/DocumentationVideo
 
If you have other suggestions/opinions on the content, feel free to share them. You can also catch me on GimpNet under the nickname "bastianilso".
 
I look forward to hear from you all, 
 
-Bastian
_______________________________________________
gnome-doc-list mailing list
gnome-doc-list gnome org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list
 
This is interesting. Thanks for putting this together.
 
One comment is that we try to avoid just describing features. We try to help users complete specific tasks, typically answering like, "How do I . . . ?".  We also occasionally address complex concepts (answering questions like "What is . . . ?") in our documentation.
 
I mention this so that you might be able to rewrite portions like, "Combined you have a library of knowledge and tools to get you up to date with the latest happenings" to something that reflects the user's goal of using that library of knowledge and tools to build and maintain applications.
 
Where do you plan to display the video?  (Just curious). 
 
Thanks again!
 
Jim
 


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]