Hi,

I just finished upgrading a 3.8 system to 4.1 and performing a fresh
install on a system that previously had Linux installed on it.
Naturally while performing these upgrades I had to occasionally
consult the OpenBSD documentation (FAQs on installation/upgrading).
The existing documentation worked fine (i.e. I never felt a need to go
find another set of guides).

I personally have never found any of these other 'guides' that are
maintained outside of the OpenBSD project useful, mainly because of a
fear that the information will be stale due to the fact it is not
maintained by a developer.

As for your prototype specifically, I can understand what you are
doing, but in order to make sure you capture all the info that is
covered in the FAQ for install/upgrade
(http://openbsd.org/faq/faq4.html), your guide would quickly grow much
larger. Plus, the FAQ is hyperlinked into different topic areas so one
can jump around easily, whereas your guide is linear.

HTH,
Walter

On 11/3/07, Karel Kulhavy <clock@twibright.com> wrote:
quoted text
> The OpenBSD has very good documentation when it comes to the manpages, but with
> the web guides there is one thing I don't like: one is presented information he
> doesn't need at the moment, which consumes time and increases likelihood of a
> mistake.
>
> So I wrote an example prototype of a guide how I imagine it.  It has only few
> paragraphs since it doesn't make sense to put work into it if you think it
> shouldn't be done this way.
>
> http://ronja.twibright.com/openbsd/
>
> I have noticed that the 4.1 guide doesn't seem to officially exist anymore. Is
> it really so?
>
> CL<