Rule enforcement

obviously you don't want to waste time writing a small essay
I recently asked a question about using PCI passthru with libvirt and Bhyve.
Nobody answered so I shot off an email to the developer who has recently added FreeBSD features to libvirt.
He was nice enough to answer and sent me a link to the manual.
I must admit I had seen the page section before (as I had poured over the excellent documentation) but could not decipher it.
So its not only new users who have trouble reading RTFM.
 
Folks,
compared to what I see on the net nowadays, this is an exceptionally nice forum. If people have questions and somebody knows the answer, the get help. And even if the answer isn't known or the question rather unenlighened, they are not bullyed, not are people downvoted for asking questions where the answer isn't obvious.
I really don't see anything that would need "enforcement".

Maybe this comes in part because we still have a couple of really "old men" here, knwing the IT since the times of Usenet or longer. I would wish that the OP would try and integrate into this community, as he is definitely not the only one here having run an UUCP site 30 years ago. ;)

And concerning the L-word - well, I dumped it in '95, so why should one care?
 
So its not only new users who have trouble reading RTFM.
Indeed. In my day, a programming career started with Karnaugh maps, and eventually progressed to assembler.
These days it's more likely to be Java. So many of the fundamentals, including system calls, are going to be a complete mystery.
Thus, your starting point may render the "fine manual" either inappropriate or indecipherable.
One of the great strengths of FreeBSD is the excellent man pages and handbook.
What percentage of Linux users know enough about emacs to use info?
 
Indeed. In my day, a programming career started with Karnaugh maps, and eventually progressed to assembler.
These days it's more likely to be Java. So many of the fundamentals, including system calls, are going to be a complete mystery.
Thus, your starting point may render the "fine manual" either inappropriate or indecipherable.

I dont think it's due to a missing link to the fundamentals, it's just: they don't do it (write manuals). And in the places where one would need the manuals, they say, read the source.

The fine thing about manuals is, they are complete and non-redundant. So, paging thru the manual you can be certain that you at least have noticed every option or feature the thing has. One will value that only later, when the problems arise: ah, there was some feature, maybe I need exactly that now, lets check that.

As I occasionally mentioned, in the first decade I was in need of some frontend for a few tables I have in postgres. And, in an attitude of "rather overkill than limitations" I choose Ruby-on-Rails - mostly because OO is more fun in ruby than in perl. Then I had to learn a lot about Webservers, about HTML etc. - but it worked, the approach did what I needed (and more), and it was certainly a step in the right direction.

But - I didn't feel well with it. Because there was nothing that would deserve the name documentation, in the sense of a finite description of a component, it's purpose, and all it's options and features. So I could not really work with the tools, because I didn't know what they can do, how they would do it, and what would be the "best practice" for a given task.
Instead, the usual way of exchanging knowledge seemed to be to exchange "recipes" in blog entries on the web, about how a certain task might be achieved. This is good for directly reproducing the same task and quickly getting results (you don't need to know anything for that), but it is bad as soon as you need a variation that is not described in the recipe. Because you have no understanding of which are the "fishbones" - the parts that are really important and hold it all together (as opposed to those parts that are fancy and a rather matter of taste).

But this seems to have become the workstyle nowadays (I call it "demomaker" workstyle *eg*). One does no longer try and understand something down to it's roots, one just looks for a recipe to make it work. This is what that whole StackOverflow venture is about: exchanging recipes, with some selection of best practices. It is not about understanding what you're doing - probably that's not required nor intended. Consequentially, if something breaks, probably no one will know how to fix it.
 
Sometimes I think FreeBSD should consider opening a Stack Exchange for questions and answers. On there, you ask a specific question about a specific problem that will result in a specific answer with a specific solution. Anything beyond a direct answer gets closed and deleted. No discussion threads allowed but then that's the problem. You lose the back-and-forth of working out a problem. Of course, you'd still have the mailing lists and IRC but I like the immediacy and quick responses of this forum that you often don't get elsewhere. (And building on a point made earlier, kids today probably can't even spell IRC.)
 
Back
Top