From owner-freebsd-questions Mon Mar 12 13:38:12 2001 Delivered-To: freebsd-questions@freebsd.org Received: from bryden.apana.org.au (bryden.apana.org.au [203.3.126.129]) by hub.freebsd.org (Postfix) with ESMTP id A0D4537B718 for ; Mon, 12 Mar 2001 13:38:06 -0800 (PST) (envelope-from dougy@bryden.apana.org.au) Received: from roadrunner (roadrunner.apana.org.au [203.3.126.132]) by bryden.apana.org.au (8.11.1/8.11.1) with SMTP id f2CLbHq05030; Tue, 13 Mar 2001 07:37:19 +1000 (EST) (envelope-from dougy@bryden.apana.org.au) Message-ID: <046701c0ab3c$c4a66300$847e03cb@apana.org.au> From: "Doug Young" To: "Duke Normandin" <01031149@3web.net>, "David Johnson" , "Mike Meyer" , Cc: Subject: Re: documentation issues generally Date: Tue, 13 Mar 2001 07:38:16 +1000 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.50.4133.2400 X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400 Sender: owner-freebsd-questions@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Seems like the docs situation is destined to keep going the same route as present. Its quite obvious that the "official" docs people are more interested in the systems used to create docs than the content thereof. The result is that more & more users (recalling their own difficulty with the official formats) will establish sites like freebsddiary / bsdvault / mostgraveconcern / freebsdzine / etc etc to cater for those who (quite rightly) believe that the official stuff is aimed at the geekship. I personally don't believe there is any point in submitting material to freebsd-docs ... I favour an infinitely more user-friendly format (eg including a bunch of screen dumps, step_by_step examples & "real world" examples of typical commands) rather than the mind numbing synopsis style complexity of the man pages. Maybe the man pages aren't the "correct" place for explicit explanations, but if thats the case then the Handbook certainly is. To be fair its definitely an improvement on what it was a year ago & light years ahead of most of the linux equivalents, however the screen dumps /examples / etc are still conspicuous by their absence. OK so some of the user-friendly sites have errors .... at least they make an honest attempt to provide information in an intelligible form which is something still lacking in the official documentation. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message