Project model

[Giorgos Keramidas]

On 2003-04-08 11:28, Greg 'groggy' Lehey <grog at freebsd.org> wrote:
> On Monday,  7 April 2003 at 13:30:10 +0200, Niklas Saers Mailinglistaccount wrote:
> > Hi all,
> >
> > I'd like to present
> > http://niklas.saers.com/freebsd-model/freebsd-model.html for review.
>
> This looks excellent!  The structure is very clear, though I haven't
> had time to check for accuracy.

Indeed.  Niklas, you have a great piece of work there!

> > Known issues:
> > 1) freebsd-code-model.png (the rather ugly hand-done drawing) will
> > be replaced soon (I'm getting help from someone a lot more skilled
> > at drawing than I am :) ).
>
> It serves its purpose.

Aye.  I'll help in my way if I can.  We could probably convert some of
the images to eps or pic code to save some repository space.  Let me
know what you want this to look like, and I'll try to convert the
pictures to a non-binary format.

> >  - are there any good tools for DocBook XML => DocBook SGML conversion?
>
> Not that I know of, but that doesn't mean anything.
>
> A couple of suggestions:
>
> 1.  Offer the document alternatively as a series of pages rather than
>     one big web page.  I personally prefer the latter, but people on a
>     slow link might find it a bit much.

This will automagically be taken care of if we use the current FreeBSD
toolchain for building the document.  FORMATS="html-split" will generate
many small pages, while FORMATS="html" a big, one-page document.

> 2.  Find yourself a doc committer to commit it for you.  It will
>     probably be faster.

This could be me.  Niklas, mail me at keramida@ and I'l take care of
test-building this, writing any Makefile glue that's needed, and then
adding this to our doc/ tree.

- Giorgos

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030408/0bbf14fa/attachment.sig>