examples

[Oswald Buddenhagen]

On Mon, Dec 05, 2011 at 12:05:13AM +0100, Aaron J. Seigo wrote:
> source code examples are to live in an examples/ directory within the given 
> framework git module. to put it simple: i object :)
> 
and i deflect. :P
this topic was discussed ad nauseam in qtdf.

examples have to live in their parent module so they can be linked from
the docs.

bigger examples with multiple dependencies (aka, demos) can be
aggregated in a separate module (qtdoc in qt, due to the surrounding
documentation).

> kdeexamples exists as a way to bring together
>
that should make you think already, given the objective of frameworks.
;)

> prevents developers, who usually work with pre-packaged binaries and
> not the upstream sources, from having to fetch each and every
> framework tarball just to see examples for it.
>
i call that a distribution problem. examples should be distributed as
source code in noarch "binary" packages (either as separate -examples,
or part of -doc).