[cairo] Some newbie question

[Nis Martensen]

In article <8763z2cn6o.wl%cworth at cworth.org> you wrote:
> > So, actually, nothing really. ... Ok, one
> > thing: I found a tiny bit confusing all this "samples", "recipes",
> > "snippets", "examples" - I wasn't really sure where to look for what.
> 
> Yeah, that's definitely some organic growth going on, (the good and
> bad of wiki-ness together). Anyone want to take a crack at imposing
> some high-level organization to this stuff? Clearly the 4 words above
> are all referring to basically the same thing, so it's not all that
> helpful having 4 separate pages.

Actually, it's only 3 three separate pages: "snippets" is not a page,
but always refers to, well, code snippets. Admittedly mostly referring
to those on the "samples" page, except in the tutorial.

"Samples" is about showing just small bits of cairo code in action while
not always reproducing whole programs, which would create unneeded
redundancy.

"Examples" has links to the "samples" page and some cairo demo code, but
mostly links to other projects using cairo.

I'm not sure where the cookbook/recipe stuff has its place in that
scheme. If you look at the recipes, you will notice that nearly
everything is showing python/pycairo code. One idea would be to move
this stuff to the pycairo section. The following would be left:

 - convertctopyandback
	
	Also move to the pycairo section?

 - operators

	Put the manual into the wiki proper and integrate this into the
	manual. Will try to do that some time next year if nobody else
	does.

 - matrix transformation reminder

	Maybe just refer to it from the manual.

We should then at least put a link to the pycairo section to the samples
page. Then we could remove the cookbook and hope that this leads to
less confusion ;-)

Until that is done, we could declare the cookbook to be some kind of
"staging area" for pieces of documentation. So if anybody wants to
improve the documentation, one could take a recipe and

 - either convert to C and add the information to the tutorial or to the
   manual

 - or move the information to a language binding page.

Thoughts?


 Nis