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

Reply via email to