On Mon, Dec 5, 2011 at 10:48 AM, Marc Espie <[email protected]> wrote: > On Mon, Dec 05, 2011 at 10:32:50AM -0500, Daniel Villarreal wrote: > > Mr. Espie, why do you presume that I'm only interested in "official" > > OpenBSD documentation ? > > Should I only read emails from Theo and the developers, then ? > > D > > I have totally nothing against 3rd party USEFUL documentation. > > I'm with you on this. This is why I haven't put out information on OpenBSD, only my personal opinion. I think that it's okay for me to put out Linux documentation because there's a lot of variance in the quaility to begin with, but with official OpenBSD documentation, I have nothing but praise... I suppose the question for me becomes one of how to make things easier to understand, or if that's even desireable.
> So far, that guy has written two pages that: > - contain factual errors > - are not even useful compared to official documentation. > I would kindly inform him so he can make changes. He does include a link to the main OpenBSD web site. > > Suppose I have an interest in seeing other people's information ? > > If I don't want to see something, I don't have to look at it. > > You're also not the one getting the panicky error reports when people > follow > some bad advice and end up fucking up their machine. > > Case in point: there's a good reason why we advise to run sysmerge AFTER > updating and NOT before. There's a very small chance it could fuck up, > and you could end up with a machine that DOESN'T REBOOT, which is a big > problem if it's located at a center. > Do you really think someone with any responsibility over an enterprise setup isn't going to research the author and the topic first? A newbie is going to mess up and have to start over again. No biggie, OpenBSD installs real fast ! > > Do you really think that you are doing any good by discouraging > people? > > By driving people away from actually trying to help people use > OpenBSD? > Mr. Espie, I don't know if you realize this, but it's there are various > reasons for not contributing to the official documentation... one is > simplicity, i.e. > > And you people want people to give you money, with your kind of > > attitude ??? > > Look, first I was helpful. Then other people pointed out that his adsuck > info > was a plain duplicate of what's currently in the port README, and he > protested his work was useful, so I'm putting things in my own perspective. > So you don't think it's possible that the author independently could come up with the same information? You're ready to pass judgement just like that? What about Newton and Leibnitz ? > you want to help people use OpenBSD, there's a *lot* of official > documentation > that could be better, start contributing to *that*. > I agree, but people tend to do as little as they have to. See FAQ 15.6. Sure it takes effort. Or one can just put up a blog. What if OpenBSD made it easier for people to contribute to documentation? I know, this isn't Linux. And the current setup is part of the reason for the excellent documentation... why fix what isn't broke ? Maybe it would help if you posted video of the developers collaborating at one of the hackathons ? And maybe some recommendations on the best humppa music to listen to ? thanks, Daniel Villarreal

