Re: [Vala] Was GNOME Panel applet example removed?

[Frederik <scumm_fredo gmx net>]

On 08/30/2011 04:44 PM, Luca Bruno wrote:
> Then say it's ultra-broken, but I don't see _any_ gain in removing
> already written stuff, docs can be kept in shape this way too. And
> keeping some more lines it's making the wiki crowded with cruft.
>
> Can I please ask you to not remove code next time but just put a big
> warning, if it's ok for you?

Then we end up having N versions of the Vala tutorial and all code
examples, for Vala versions 0.14, 0.12, 0.10, 0.8, ..., not just for
the most recent stable release, multiplied with all the different
versions for each library. I can't imagine anyone who would like to
maintain this. It's a wiki. Old versions are saved in the history. And
old samples can still be found on http://code.valaide.org/.

In my point of view documentation by example is not just unspiritual
accumulation of code chunks without keeping them in shape. Less can be
more. At least we should have a policy regarding when example code is
considered old and unmaintained enough to be removed. Or a sub-page
named "Deprecated stuff" where all deprecated code samples go in, so
that I wouldn't feel the urge to look after it.


Best regards,

Frederik