From owner-freebsd-doc Wed Oct 18 10:43:21 2000 Delivered-To: freebsd-doc@freebsd.org Received: from virtual.sysadmin-inc.com (lists.sysadmin-inc.com [209.16.228.140]) by hub.freebsd.org (Postfix) with ESMTP id C6FAF37B4E5; Wed, 18 Oct 2000 10:43:16 -0700 (PDT) Received: from 98wkst ([10.10.1.71]) by virtual.sysadmin-inc.com (8.9.1/8.9.1) with SMTP id NAA16960; Wed, 18 Oct 2000 13:47:30 -0400 Reply-To: From: "Peter Brezny" To: "'Nik Clayton'" Cc: Subject: RE: How To's Date: Wed, 18 Oct 2000 13:43:23 -0400 Message-ID: <000801c0392a$ea66f700$47010a0a@fire.sysadmininc.com> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook CWS, Build 9.0.2416 (9.0.2910.0) In-reply-to: <20001018070232.C9427@canyon.nothing-going-on.org> X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400 Importance: Normal Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Ok Nik, Thanks for the info. I do think, however, that after all the buzz in the doc mailing list, that it may be very important to create a new subcategory of documentation. I don't think it's a good idea to mix the current style of thorough hard core indepth documentation we have with the how to 'step by step' style. Steve Roome recently added some valuable comments. Freebsd needs a category of documentation that is geared towards the 'oh crap it's broken how do i get it started again' situation, which currently seems to be non existent. a new area, possibly just on the web like has been suggested. even call it freebsd step by step or something else if we want to keep away from the mindset of the linux how to or as steve mentioned, have an area where anyone can contrubute anything and then perhaps a more 'official area' where the contributions have been reviewed and made sure to be correct, the bottom line is we need some kind of step by step documentation, and i think to be true to the current documentation project, it would be bad to mix it in and water down the current hard core documentation that the super users are accustomed to. there's my two cents. I'll let you know when we've got some articles to contribute. but do consider opening up a new category of documentation. Peter Brezny SysAdmin Services, Inc. -----Original Message----- From: Nik Clayton [mailto:nik@freebsd.org] Sent: Wednesday, October 18, 2000 2:03 AM To: Jordan Hubbard Cc: Nick Rogness; Rick Hamell; Peter Brezny; freebsd-doc@freebsd.org Subject: Re: How To's On Mon, Oct 16, 2000 at 06:00:59PM -0700, Jordan Hubbard wrote: > > I have a lot of documentation (HOW-TO's) that I have written up. > > Well, most of it is actually my notes...but could be converted to > > HOW-TO's with little effort. Most of it is how to put everything > > together to work right. This stuff is all geared toward the > > I think Nik Clayton should simply pursue you to the ends of the earth, > if necessary, and get you to join the FreeBSD Documentation Project so > that you can do exactly that and get it all linked into the main site > (and all its mirrors). :-) Er, what he said. :-) I've posted the URLs to our meta documentation explaining how to write documentation elsewhere in this thread. Let me know if that's sufficient, and if there's anything else that you guys need to get started. Standard rules apply -- show sufficient motivation, and I'll have you sorted out with a commit bit so fast your feet won't hit the floor :-) N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message