Date: Wed, 15 Jul 1998 02:27:27 -0700 From: Tim Gerchmez <fewtch@serv.net> To: Donald Burr <dburr@POBoxes.com>, newbies@FreeBSD.ORG Subject: RE: Don't log onto current.freebsd.org... Message-ID: <3.0.5.32.19980715022727.00809560@mx.serv.net> In-Reply-To: <XFMail.980715014609.dburr@POBoxes.com> References: <3.0.5.32.19980714215811.00803870@mx.serv.net>
next in thread | previous in thread | raw e-mail | index | archive | help
Donald, I'll take you up on that offer. Over the next couple weeks I'm going to read the FAQ and handbook VERY carefully, find out which sections need beefed up or are "under construction" that I think I could contribute to, and will write some documentation if I find anything. You *will* have to convert to SGML for me... let me know which you would prefer, plain ASCII text (DOS format, not Unix) or MS Word 95 (= Word 6 AFAIK) format. I could even contribute in straight HTML if it would be easier for you to re-markup the material that way (I know SGML is a superset of HTML). Please let me know, as I will be beginning this project soon. I might also consider writing an "Absolute beginner's guide to installing FreeBSD" for those coming from the DOS/Windoze world who are used to handholding, detailing my experiences, what kind of gotchas I've found are in SYSINSTALL, etc). What do you think of that idea? Seems to me that could be something REALLY useful for many, and I would even be willing to post it to my website as well as maybe having it on the FreeBSD site somewhere. Tim At 01:46 AM 7/15/98 -0700, Donald Burr wrote: >* DOCUMENTATION. We need documentation! Just take a look at the FAQ or >the Handbook (*especially* the Handbook) and you'll see a lot of sections >that are not the easiest/clearest to read, are missing some parts, or are >just plain missing entirely. Plus, IMHO, FreeBSD needs a lot of smaller >"HOW-TO" type documents, similar to what the Linux people have, that guide >the user through setting up ONE specific thing (e.g. PPP, DNS, et al). >If you know how to do the task (ex. setting up PPP), and you know English, >that's all you need. (Even if you don't know English, FreeBSD *NEEDS* >documentation in other languages too!) > >Some people say "wow, the documentation is written in TeX or SGML >(or some other weirdo format) that I don't know. But, you don't need >to nkow how to use SGML, *roff, postscript, or any of the other >documentation writing languages out there. You can always write your >stuff in plain ASCII text, Microsoft Word, or whatever, and someone else >[for example, myself] would be happy to convert it into the appropriate >format. -- My web site starts at http://www.serv.net/~fewtch/index.html - lots of goodies for everyone, have a look if you have the time. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-newbies" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?3.0.5.32.19980715022727.00809560>