Re: OpenBSD Traning Docs / How Tos

2017-08-08 Thread Tom Smyth
Hello Ingo, Theo, all, Thanks for taking the time to respond to my mail, I understand & agree with many of your points made, the ones I disagree with I will discuss with you over a Pint of Beer or 2, at some conference :) Ill take on board your suggestions of lots of little edits / little patch

Re: OpenBSD Traning Docs / How Tos

2017-08-08 Thread Nick Holland
On 08/08/17 03:54, Mihai Popescu wrote: > Hello Tom, > > I am not an expert user of OpenBSD but I want to tell you the FAQ is > the first step. That is maintained by Nick Holland, ... I really hate to correct someone who says such nice things about my work, but ... I stepped aside a while back t

Re: OpenBSD Traning Docs / How Tos

2017-08-08 Thread Mihai Popescu
Hello Tom, I am not an expert user of OpenBSD but I want to tell you the FAQ is the first step. That is maintained by Nick Holland, an OpenBSD user an a man with great experince on the field. You may think that FAQ is redundant for man, or even that man paragraphs are simply copied into the FAQ, b

Re: OpenBSD Traning Docs / How Tos

2017-08-07 Thread Theo de Raadt
> both regarding content and markup (including pf.conf(5) and > ifconfig(8)), and that is not a coincidence: The subject matter is > unusually difficult, the number of features to explain is unusually > large, the number of people qualified to judge the accuracy of the > manual pages and proposed c

Re: OpenBSD Traning Docs / How Tos

2017-08-07 Thread Ingo Schwarze
Hi Tom, you are aware that the term "HOWTO" is very strongly detested round here, right? It is considered a synonym for so-called documentation that is imprecise, unsystematic, and tells the user to type some random commands they won't understand because the HOWTO doesn't really explain how thing

OpenBSD Traning Docs / How Tos

2017-08-07 Thread Tom Smyth
Hello ladies and lads, Im currently working on internal training documentation for our operations and field teams for dealing with OpenBSD based equipment. These documents would focus on OpenBSDs Network stack and its capabilities, diagnostics and configuration manipulation Since Im going to that