Re: I am sick and tired of the poor quality of documentation on FreeBSD

On Tue, Nov 21, 2023 at 10:27 PM Joe B <jcb2023az@gmail.com> wrote:

> On Tue, 21 Nov 2023 20:51:01 +0100 (CET)
> iio7@tutanota.com wrote:
>
> > Take a look at how it's done on OpenBSD! Take a look at have it's
> > done on Arch Linux!
> >
> > When there is something that is going to break something during an
> > upgrade, you get timely information and a step by step instruction in
> > what to do - BEFORE you do it!
> >
> > Something like this doesn't help!
> >   Pool 'zroot' has the bootfs property set, you might need to update
> > the boot code. See gptzfsboot(8) and loader.efi(8) for details.
> >
> > I might need to update the boot code!? WTF does that even mean?
> >
> >  I never touched any boot code during installation so I don't even
> > know what that is! And reading those man pages did NOT help me in any
> > way.
> >
> > So now I got a box that's borked with this beautiful message after
> > updating the zroot pool:
> >
> > ZFS: unsupported feature: com.delphix:head_errlog
> > ZFS: pool zroot is not supported
> > Can't find /boot/zfsloader
> > Can't find /boot/loader
> > Can't find /boot/kernel/kernel
> >
> >
> >
>
> I know exactly what you are going through i updated to 14.0-RELEASE
> from 13.2-RELEASE and i was stuck. I didn't know what to do. There are
> some outlets that can help though until the documentation gets better
> like the arch wiki and other places.
>
> I Been on FreeBSD a week
>
> 1. https://forums.freebsd.org/
> 2. https://libera.chat/ then join #freebsd
> 3. https://discord.com/ & https://wiki.freebsd.org/Discord join the
> #helpdesk channel
> 4. https://unix.stackexchange.com/questions/tagged/freebsd
> 5. This mailing list
> https://lists.freebsd.org/subscription/freebsd-questions
>
> When you ask for help don't complain just ask and layout what you've
> done and what you are looking for and you will get a response.
>
> Try it.
>
> Joe B
>
>
Bravo.  No seriously bravo.  There's the right way and then there's the
wrong way.
This approach from Joe is the correct approach.  He's upfront and appears
genuine.
Essentially:  "I'm a noob and need help".  Perfect, let us have at it.


Then there's the "I've been doing this for 20 year types (doubful in this
case) and I fucked up, yet instead of asking for help I'm just going to
complain" type.
And with that I say: If you actually have been using FreeBSD for 20 years
and you want to complain ... fix it yourself.

You know what us "old timers" do when we run into trouble?  The first thing
is we don't complain about the thing we've been using for 27 years (in my
case).
The second "real" thing we do is go and check the bug reports for our
issue.  99% of the time I found what I was looking for.
The third thing, if the second thing wasn't good enough, this list with
enough information in hope that someone would help you. -- In most cases
they do.  If not this list than the other resources shared by Joe.

.. and with that, I welcome Joe.  You've probably already contributed more
in your week here than iio7 has in his past 20 years.  ;)

~Paul

-- 
__________________

:(){ :|:& };: