> From: [email protected]
> Date: Mon, 10 Dec 2012 13:29:00 +0100
> To: [email protected]
> Subject: [Emc-developers] Cmorley: thanks for documenting this
>
> I would like to encourage a public thanks to Chris Morley for doing this:
>
> http://www.linuxcnc.org/docs/2.5/html/common/python-interface.html
>
> it takes another round of guessing and needless guru factor out of
> programming LinuxCNC
>
> Let me add a word to authors of such core code:
>
> a) great that you wrote it, and in such a clever way - thanks for that
> b) without properly documenting it, it is merely yet another arcanum in the
> overfull cellar of undocumented bodies of LinuxCNC
>
> without that, all it might do is prove the authors cleverness; it also proves
> how much the author gives about same code being usable by someone else - not
> very much, that is. The fact that one can read the source is not a valid
> excuse.
>
> - Michael
>
Well ummm I didn't write it....
I'm pretty sure you did. :)
I was just asking John to add it to the docs which he already had.
But you bring up a great point that documentation is so important - there are
lotsa goodies
hidden in linuxcnc if you know where to look.
I am very proud of what this project does and how well it does it.
Sure there are things to improve - but we should also be proud of what it is.
One could complain about our docs some but at least there are docs and they
are kept pretty up to date.
In particular I thank John T for his continued work on the formal docs and his
recent
work on tutorials. ( that should be added to the manual when finished )
I also would like to thank Michael for documentation of his development work.
Writing docs sucks so writing docs for stuff your not sure will pan out has got
to be difficult to get through.
And there are lots of other people out there too - you are all important for
our success.
I am very happy that we aren't so arrogant that we discourage non gurus from
participation.
I am excited about linuxcnc3 planning and the new realtime options...
Chris M
------------------------------------------------------------------------------
LogMeIn Rescue: Anywhere, Anytime Remote support for IT. Free Trial
Remotely access PCs and mobile devices and provide instant support
Improve your efficiency, and focus on delivering more value-add services
Discover what IT Professionals Know. Rescue delivers
http://p.sf.net/sfu/logmein_12329d2d
_______________________________________________
Emc-developers mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/emc-developers
