Date: Fri, 23 Nov 2001 07:39:11 -0800 From: Murray Stokely <murray@FreeBSD.org> To: Dag-Erling Smorgrav <des@ofug.org> Cc: doc@FreeBSD.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/articles/problem-reports Makefile article.sgml Message-ID: <20011123073911.X27929@windriver.com> In-Reply-To: <xzppu6aw9gs.fsf@flood.ping.uio.no>; from des@ofug.org on Fri, Nov 23, 2001 at 02:40:35AM %2B0100 References: <200111230101.fAN11pj06499@freefall.freebsd.org> <xzppu6aw9gs.fsf@flood.ping.uio.no>
next in thread | previous in thread | raw e-mail | index | archive | help
--HxQt9wRz9wbL5Edg Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Nov 23, 2001 at 02:40:35AM +0100, Dag-Erling Smorgrav wrote: > Dag-Erling Smorgrav <des@FreeBSD.org> writes: > > Add an article about writing good problem reports. It's a little thi= n in > > places, but I think it's a good start. I'll connect it to the build = once > > it's been reviewed by the appropriate people. >=20 > I'd like to get some feedback about the markup here - it's the first > time I more than just a few paragraphs in DocBook, and I'm sure to > have messed something up. I'll connect the article to the doc build > once I'm satisfied that it's fairly palatable both from a content and > a markup point of view. The content and markup of the article look great. I just noticed one misspelling of "enhancements" but everything else looked very nice. > I'm particularly interested in suggestions about improving the > connectivity to and from the article (i.e. adding index terms and > adding links to other related documents). Currently, we only have support for a per-document index, although I hope we will implement a global index of our entire documentation set sometime soon. You should add a cross-reference for the "Contributing to FreeBSD" article somewhere, since that document goes into more detail about submitting patches to the source tree, etc (and the Developer's Handbook goes into even more). Thanks, - Murray --HxQt9wRz9wbL5Edg Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (SunOS) Comment: For info see http://www.gnupg.org iD8DBQE7/m2etNcQog5FH30RAoLKAKCLGvY12aY+l2R+9IeBYlkYj9gt5gCgn+sD h2i3zT2ngyhr3TTfnSe+p28= =0IXi -----END PGP SIGNATURE----- --HxQt9wRz9wbL5Edg-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20011123073911.X27929>