På Thu, 27 Feb 2014 05:17:07 +0100, skrev anatoly techtonik
<[email protected]>:
On Wed, Feb 26, 2014 at 12:19 AM, Gary Oberbrunner
<[email protected]> wrote:
On Tue, Feb 25, 2014 at 3:30 PM, Russel Winder <[email protected]>
wrote:
On Tue, 2014-02-25 at 22:55 +0300, anatoly techtonik wrote:
> Hi again,
>
> How about opening https://bitbucket.org/scons/contrib with various
> bits and pieces that people previously posted to Wiki? Tools and
> stuff. Learning be example may be much easier than by following the
> docs.
Any code on the wiki should be removed, wikis are not the place for
code, version control repositories are the place for code.
I must object on this. Based on the experience in my company we use wiki
snippets extensively, while we have only once used a repository for
fetching
any code. As a developing tool VCS is great, as a resource for learning,
not so much. I beg you to consider that many companies developing software
doesn't even use VCS for their own software, do you then expect them to
learn how to pull a repository just for finding out how to make an emitter.
I for my part would have had a hard time convincing my fellow developers
from
using Scons without showing them the vast amount of examples and snippets
found
on the Scons wiki and stackoverflow
Yes, but. Wikis are excellent places for snippets and small code chunks
(think about stackoverflow for instance); creating a repo just for your
little 10-line thing is worse: more effort and little to no gain.
Anything
larger than a single function though, I agree with you.
Sane diffs, history of changes and ability to browse with your editor is
good
for code regardless of its size. Repository has a lower entry barrier
than the
wiki. Also it is primarily for code that is more than 10-line thing.
All things considered, I think this is a discussion that should be placed
on
the user mailing list, as this affects the users more than the developers,
and the usage pattern of the users should be the the decisive factor in
such a
matter.
For me ease of use is one of the strong points of Scons, the samples on
the wiki
reflects just that. For me, googling "Scons add dynamically" and finding a
snippet
that demonstrate an emitter is one of the joys of Scons.
--
Sendt med Operas revolusjonerende e-postprogram: http://www.opera.com/mail/
_______________________________________________
Scons-dev mailing list
[email protected]
http://two.pairlist.net/mailman/listinfo/scons-dev
