Date: Thu, 26 Dec 96 19:46:56 -0400 From: "Francisco Reyes" <francisco@natserv.com> To: "FreeBSD doc Mailing list" <doc@freebsd.org> Subject: Suggestions for documentation. Message-ID: <199612270047.TAA27484@revelstone.jvm.com>
next in thread | raw e-mail | index | archive | help
In the newsgroup J"org wrote: >Great! Would you perchance be willing to contribute this in SGML, >too, so it can become a part of the handbook? And I answered: I think that we need to add some info on the handbook on how to submit documents and some basic info on SGML. I recall once I wanted to help with the documentation project and I didn't get very far because I did not know SGML and there isn't much online anyway. There is practically nothing in the handbook which indicates how/where to send contributions. If someone from the documentation project could spend some time in writing the basics for people who would like to contribute it would pay off in the long term. I suggest we addis that in the handbook: -A few basic sample SGML pages so people can use them as guide -Where existing documents are so people can FTP them to study them and modify them. -What are the programs one need to use to validate/parse (or whatever one needs to do with SGML). -How to submit code (ie if it is just minimal changes use diff otherwise if it is new or a complete overhaul send it to xyz destination for review).
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199612270047.TAA27484>