[prev in list] [next in list] [prev in thread] [next in thread] 

List:       gstreamer-devel
Subject:    [gst-devel] gstreamer application developer and plugin writer manuals
From:       Stefan Kost <ensonic () hora-obscura ! de>
Date:       2006-01-31 12:12:39
Message-ID: 43DF5437.9060903 () hora-obscura ! de
[Download RAW message or body]

hi all,

I like to spend some time going over out development manuals
http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/index.html
http://gstreamer.freedesktop.org/data/doc/gstreamer/head/pwg/html/index.html

First goal 1 is to prepare a list on
http://live.gnome.org/GStreamerDocsTriage
for these manuals, conatinig the section in doubt.

Second I like to do something about the duplication in the introduction.
I like both documents to start with chapter like this:
I Introduction
   1 Who should read this document?
   2 Preliminary reading
   3 Structure of this document
II GStreamer concepts
   GStreamer (will contain 'Motivation & Goals' from the manual)
   Elements
   Bins and pipelines
   Pads and Caps
   Buffers
   Events
   Metadata (Tags)
   ... (probably more to add)

Then both guide will continue with application/plugin specific docs:
III Building an application (was Basic Concepts)
III Building a plugin

The part 'II GStreamer concepts' should be identical for both. Therefore I'd 
like to add directory under docs, say 'concepts' and put there files there. Both 
guides will then just reference them from there.

Pros and cons?

Stefan


-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems?  Stop!  Download the new AJAX search engine that makes
searching your log files as easy as surfing the  web.  DOWNLOAD SPLUNK!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642
_______________________________________________
gstreamer-devel mailing list
gstreamer-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gstreamer-devel
[prev in list] [next in list] [prev in thread] [next in thread]