Re: Documentation Video Proposal

[Jim Campbell <jcampbell gnome org>]

Hi Bastian,

On Mon, Apr 28, 2014 at 12:52 PM, Bastian Hougaard <hougaard junior gmail com> 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 do more than just describe application features. Instead 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. That's our goal.  : )

Does that make sense? Let us know if you'd like to discuss further.

 

Also, where do you plan to display the video?  (Just curious). 

 

Thanks again!

 

Jim