[gst-devel] gstreamer application developer and plugin writer manuals

[Stefan Kost]

hi,

thanks Thomas and Wingo for replying. Sorry, I was indeed a bit impatient. Its 
on my todo list since quite a while and I had a free evening ahead. I'll prepare 
a plan and ask again. I did some cleaning up already. Means I revert withdrawing 
my proposal ;)

Ciao and happy hacking!
   Stefan


Thomas Vander Stichele wrote:
> On Tue, 2006-01-31 at 13:12 +0100, Stefan Kost wrote:
> 
>>First goal 1 is to prepare a list on
>>http://live.gnome.org/GStreamerDocsTriage
>>for these manuals, conatinig the section in doubt.
> 
> 
> (With the knowledge of your following mail)
> I would advise that you first outline your plan so that we can get
> people behind it.  Implementing step 1 of your plan straight away is
> going to make you bitter (see your mail)
> 
> I'm sure people are interested in this, but sadly you will need to poke
> people on IRC regularly as you update, wiki's are not easy to follow all
> the time if it's not your number 1 priority.
> 
> 
>>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)
> 
> 
> Great idea.
> 
> Does that mean you copy the exact same content in both manuals ? Or do
> you refer from both manuals to an introduction guide ?
> 
> Historically crosslinking between manuals has not been easy, though it
> could still be done.
> 
> Thomas
> 
> Dave/Dina : future TV today ! - http://www.davedina.org/
> <-*- thomas (dot) apestaart (dot) org -*->
> if you ever lay a finger on my left side
> if you ever lay a finger on me I will open
> <-*- thomas (at) apestaart (dot) org -*->
> URGent, best radio on the net - 24/7 ! - http://urgent.fm/
> 
> 
>