💾 Archived View for perso.pw › blog › articles › blog-highlight.gmi captured on 2022-04-29 at 12:30:16. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2021-12-17)
-=-=-=-=-=-=-
NIL=> Comment on Mastodon
Today I will write about my blog itself. While I started it as my own
documentation for some specific things I always forget about (like
"How to add a route through a specific interface on FreeBSD") or to
publish my dot files, I enjoyed it and wanted to share about some
specific topics.
Then I started the "port of the week" things, but as time goes, I find
less of those software and so I don't have anything to write
about. Then, as I run multiples servers, sometimes when I feel that
the way I did something is clean and useful, I share it here, as it is
a reminder for me I also write it to be helpful for others.
Doing things right is time consuming, but I always want to deliver a
polished write. In my opinion, doing things right includes the
following:
- explain why something is needed
- explain code examples
- give hints about potential traps
- where to look for official documentation
- provide environment informations like the operating system version
used at the writing time
- make the reader to think and get inspired instead of providing a
material ready to be copy / pasted brainlessly
I try to keep as much as possible close to those guidelines. I even
update from time to time my previous articles to check it still works
on the latest operating system version, so the content is still
relevant. And until it's not updated, having the system version let
the reader think about "oh, it may have changed" (or not, but it
becomes the reader problem).
Now, I want to share about some OpenBSD specifics features, in a way
to **highlight** features. In OpenBSD everything is documented
correctly, but as a Human, one can't read and understand every man
page to know what is possible. Here come the highlighting articles,
trying to show features, how to use it and where they are documented.
I hope you, reader, like what I write. I am writing here since two
years and I still like it.