Skip site navigation (1)Skip section navigation (2)
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>