On 10/08/2016 02:23 PM, Zeev Pekar wrote:
> Ok. I understood the consequences - I'll operate on a copy of a repo. So
> could you, please, provide the two examples anyway?

*snide humor alert*

The reluctance of some programmer communities to provide examples has
always surprised me. I think documentation would be much more effective
if there were comprehensive examples throughout. It seems like those
comprehensive examples could be written in a way such that they could be
executed as part of the test suite, mostly as a way to verify that the
documentation is still in sync with the source.

But I come from an electrical engineering education where the goals are
to create clear, concise understandings in the most efficient and
effective way. Open source software communities seem to have different
values/cult'ure.

_______________________________________________
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Reply via email to