Bug 37037

Summary: Cleaned and revised the Hubs article
Product: Documentation Reporter: dominic_marks <dominic_marks>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me CC: keramida
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description dominic_marks 2002-04-13 13:40:01 UTC
	Most of my changes are relating to the text. Changing the sentences
	so they flow better, correcting spelling mistakes and so on. Some
	increased application of the right DocBook tags has also been done.
	
	I also spent time reworking the lines so that the wrap less or when
	they do in a cleaner fashion which makes this file easier to edit.

	The original file also contains a lot of ambigous statements, using
	words like "maybe", "probably" and so on. I have attempted to
	replace these with factual statements where possible.

	Please give the spelling, grammar and SGML a good checking, since I
	am likely to have made some mistakes.

	Thanks.

Fix: ? article.html
? docbook.css
How-To-Repeat: 	NA.
Comment 1 ue 2002-04-13 19:01:59 UTC
On Sat, Apr 13, 2002 at 01:34:07PM +0100, Dominic Marks wrote:
> 	I also spent time reworking the lines so that the wrap less or when
> 	they do in a cleaner fashion which makes this file easier to edit.

And these changes make it way harder for the translators to see
which changes need to be merged into the translations.  Just ignore
the whitespace (line breaks, intendation) while you are fixing the
content.  Once the content has been fixed, the whitespace can be
fixed by a perl script.

/s/Udo
-- 
I have the heart of an innocent child -- in a small jar on my desk
Comment 2 dominic_marks 2002-04-13 20:03:26 UTC
On Sat, Apr 13, 2002 at 08:01:59PM +0200, Udo Erdelhoff wrote:
> On Sat, Apr 13, 2002 at 01:34:07PM +0100, Dominic Marks wrote:
> > 	I also spent time reworking the lines so that the wrap less or when
> > 	they do in a cleaner fashion which makes this file easier to edit.
> 
> And these changes make it way harder for the translators to see
> which changes need to be merged into the translations.  Just ignore
> the whitespace (line breaks, intendation) while you are fixing the
> content.  Once the content has been fixed, the whitespace can be
> fixed by a perl script.

Ok, in future I won't change it. Thanks for the tip.

> /s/Udo
> -- 
> I have the heart of an innocent child -- in a small jar on my desk

-- 
Dominic
Comment 3 Giorgos Keramidas freebsd_committer freebsd_triage 2002-04-13 23:25:14 UTC
On 2002-04-13 20:01, Udo Erdelhoff wrote:
> On Sat, Apr 13, 2002 at 01:34:07PM +0100, Dominic Marks wrote:
> > 	I also spent time reworking the lines so that the wrap less or when
> > 	they do in a cleaner fashion which makes this file easier to edit.
>
> And these changes make it way harder for the translators to see
> which changes need to be merged into the translations.

I'm already working with Dominic on cleaning up this patch, and
bringing the diff in shape.  I'll have a patch that looks nice when
diff'ed (from a translators's point of view) real soon now ;-)

If nobody objects to the change (like, for instance one of the authors
of the article, who happens to work on changes and feels a commit
would make his life harder), I'll gladly take care of this PR.

I also plan a whitespace, indentation, SGML pedantry pass right
*after* this has been brought in the tree, if this is ok too.

- Giorgos
Comment 4 Jun Kuriyama 2002-04-13 23:59:22 UTC
At Sun, 14 Apr 2002 01:25:14 +0300,
Giorgos Keramidas wrote:
> I'm already working with Dominic on cleaning up this patch, and
> bringing the diff in shape.  I'll have a patch that looks nice when
> diff'ed (from a translators's point of view) real soon now ;-)
> 
> If nobody objects to the change (like, for instance one of the authors
> of the article, who happens to work on changes and feels a commit
> would make his life harder), I'll gladly take care of this PR.
> 
> I also plan a whitespace, indentation, SGML pedantry pass right
> *after* this has been brought in the tree, if this is ok too.

I don't care to commit any refinement and clean up.  Please go ahead.


-- 
Jun Kuriyama <kuriyama@imgsrc.co.jp> // IMG SRC, Inc.
             <kuriyama@FreeBSD.org> // FreeBSD Project
Comment 5 Giorgos Keramidas freebsd_committer freebsd_triage 2002-04-14 01:11:28 UTC
Responsible Changed
From-To: freebsd-doc->keramida

I've started cleaning up the patch with Dominic's assistance. 
Should be ready later tonight.
Comment 6 Dominic Marks 2003-04-12 18:48:29 UTC
Hey,

I think this PR can now be closed.

Thanks Giorgos,
-- 
Dominic
 <dom at cus.org.uk> <d.marks at student.umist.ac.uk>
Comment 7 Giorgos Keramidas freebsd_committer freebsd_triage 2003-05-03 22:56:53 UTC
State Changed
From-To: open->closed

Submitter says this can be closed now.  My apologies for letting 
it rot for such a long time without doing anything, Dominic :/