View Single Post
Old 28th October 2008
jggimi's Avatar
jggimi jggimi is offline
More noise than signal
 
Join Date: May 2008
Location: USA
Posts: 7,984
Default

A few points about OpenBSD "HowTo" documents, found in the wild. The OpenBSD Project is opposed to them, culturally, because:
  • They are usually written by new users, who are justifiably proud of their accomplishment.
  • They often do not take into account that readers may not have the exact same software or hardware environment as the author.
  • They often do not take into account that readers may have less knowledge than the author.
  • They often do not carefully explain the reasons a particular command or instruction is recommended, nor what that command or instruction actually does.
  • They are often unmaintained and out of date.
That doesn't mean all "Howto" documents are bad. I posted one recently in the Guides section on this forum. Rather, whenever you elect to read a guide you found in the wild, keep these likely weaknesses in mind.

Long time OpenBSD users are more likely to submit FAQ updates, when applicable, or perhaps submit articles for publication in the OpenBSD Journal.
Reply With Quote