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.