Stefan Hundhammer napsal(a): > On Wednesday 02 April 2008 15:16, Lukas Ocilka wrote: >>> This is documentation? You're kidding, right? >> Click on an agent path to see what happens. > > Well, yes - sometimes I get a rudimentary example (no real explanation, of > course), sometimes not even that. Often there is not even any word about > parameter or return values. > > Really, IMHO this is completely worthless. A few examples: > > http://forgeftp.novell.com/yast/doc/SL11.0/scr/108.passwd.html > http://forgeftp.novell.com/yast/doc/SL11.0/scr/109.pattern.html > http://forgeftp.novell.com/yast/doc/SL11.0/scr/105.network.html > > Lately there was a discussion about YCP and why many people consider it > inferior to other scripting languages. But frankly, I see many of our > other "tools" (in particular SCR) as a much bigger obstacle for community > involvement. Who would like to program in a development environment like > this?
You might be interested in the fact the developers of those agents are responsible for the documentation as well. Is is a generated documentation. http://forgeftp.novell.com/yast/doc/SL11.0/tdg/documentation_SCR.html Someone might go through all the SCR agents and report missing documentation, any volunteer? L.
signature.asc
Description: OpenPGP digital signature
