Re: Documentation Video Proposal

[Jim Campbell <jcampbell fastmail fm>]

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