Bug 32697

Summary: [NEW ARTICLE] - Release Engineering of FreeBSD 4.4
Product: Documentation Reporter: Hiten Pandya <hiten>
Component: Books & ArticlesAssignee: Murray Stokely <murray>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
releng.tar.gz none

Description Hiten Pandya 2001-12-11 16:20:01 UTC 
This paper was originally presented by Murray Stokely at the
BSDCon 2001 Europe (Brighton UK).

I found this paper very useful, so i converted it to DocBook SGML with
FreeBSD Extensions.

The article has been reviewed by the Author himself, all it needs is
commiting.

I am attaching a uuencoded file which has the releng.tar.gz encoded
which holds the article...

BTW: This article has been revised from www/en/internal/releng.html

=Hiten
=<hiten@uk.FreeBSD.org>

How-To-Repeat: not applicable.
Comment 1 Murray Stokely freebsd_committer freebsd_triage 2001-12-15 19:27:18 UTC 
Responsible Changed
From-To: freebsd-doc->murray

It's my article after all, I'll review this over the weekend.
Comment 2 Murray Stokely freebsd_committer freebsd_triage 2002-01-01 05:33:19 UTC 
State Changed
From-To: open->closed

This article has been committed.  Thanks for all of your work on the 
Doc Project recently, it is definitely appreciated.  I made a number 
of changes, but there is still work that could be done to this 
article. 

Changes : 

* Removed the copyright notice and such.  Most of the other articles 
don't seem to have this, I think we should just have a link to a 
legal notice at the bottom of all articles or something, I don't 
want to clutter the content with a full screen of legalese. 

* Removed the gnats.png file.  This should be dynamic, since it is 
constantly changing.  A new version of that graphics file is built 
every night at http://www.freebsd.org/prstats but I'm not sure how 
to include it. 

* Removed the branches.png file.  I added some makefile magic to 
turn a branch.tex file into an eps file that can then be converted to 
PNG.  This allows more output formats to work properly. 

* Added '$FreeBSD$' to each file, and removed '$Id$' and '$Date$'. 

* Fixed two or three misspelled words, as pointed out by ispell(1). 

* Added <literal> around the tag names, such as RELENG_4_4_0_RELEASE. 

What we can still do : 

* Use better links for the references/end notes.  These should by 
hyperlinked in the HTML version.  I'm not sure what DocBook tag is 
best for this, but I know there are several to choose from. 

* Make a change to the docbook.css file or the DSSSL stylesheets to 
make the titlepage (title, author, abstract) centered.  This would 
look much nicer but I couldn't get the CSS to work for my browser. 
It would be trivial in DSSSL but I think it really belongs in the 
CSS.