Re: man 9 intro - improvements [and learning for me]?

2023-09-19 Thread Christoff Humphries
--- Original Message --- On Tuesday, September 19th, 2023 at 7:03 PM, Theo de Raadt wrote: > > > Ingo, that's a bit cynical. > > > As long as the process is slow, step by step, adding one or two manuals at > a time, and focusing on being ACCURATE, then it will be good. > > It

Re: man 9 intro - improvements [and learning for me]?

2023-09-19 Thread Theo de Raadt
Ingo, that's a bit cynical. As long as the process is slow, step by step, adding one or two manuals at a time, and focusing on being ACCURATE, then it will be good. It would be wrong to add inaccurate pages. A lack of documentation is slightly better than inaccurate documentation. So if you

Re: man 9 intro - improvements [and learning for me]?

2023-09-18 Thread Ingo Schwarze
Hi Christoff, of course you are free to work on whatever interests you, but if you are looking for advice, i'd respectfully recommend that you try to work on specifics rather than on generalities first, in particular when you feel as if your experience in contributing isn't above average. That

Re: man 9 intro - improvements [and learning for me]?

2023-09-18 Thread Jason McIntyre
On Mon, Sep 18, 2023 at 12:21:48PM +, Christoff Humphries wrote: > Greetings all. > > I went searching for documentation about the kernel internals and was > used to the intro(9) man page from NetBSD > https://man.netbsd.org/intro.9 that had a lot more details. Would it > be a worthwhile

man 9 intro - improvements [and learning for me]?

2023-09-18 Thread Christoff Humphries
Greetings all. I went searching for documentation about the kernel internals and was used to the intro(9) man page from NetBSD https://man.netbsd.org/intro.9 that had a lot more details. Would it be a worthwhile project to attempt to do the same for OpenBSD? I understand the annoyance of folks