>>> Igor Sobrado 7-Dec-06 19:29 >>>
>
> Attached is the first draft of the patch.  Once it has been debugged I
> will open a bug report on it.  Please, check carefully all the entries

Don't create a bug report for this.  This is not a bug.  This is a
change of style that you (and some others) would like to see in the FAQ.
Nick, myself, and other people who work on the FAQ read misc@; there's
no point just pi**ing us off by calling this a "bug".

> diff -urNp www/faq1.html www.new/faq1.html
> --- www/faq1.html     2006-12-07 17:05:55.000000000 +0100
> +++ www.new/faq1.html 2006-12-07 18:55:51.000000000 +0100
> @@ -275,7 +275,8 @@ Theo de Raadt, located in Canada.
>  
>  The OpenBSD team makes a new release every six months, with target release
>  dates in May and November.  More information on the development cycle 
> -can be found <a href="faq5.html#Flavors">here</a>.
> +can be found in the <a href="faq5.html#Flavors">OpenBSD's Flavors</a>
> +subsection of this FAQ.

I personally find this clunky.

It now reads: "More information... can be found in the OpenBSD's Flavors
subsection of this FAQ."

I personally prefers something along the lines of "More information...
can be found in section 5 of the FAQ."  (with the link on "section 5
of the FAQ")  But Nick and I discuss changes like this backwards and
forwards quite a bit from time to time... that is why this is not a
mechanical set of changes, but one that requires a lot of effort and
no small ability with the English language

>  <a name="Included"></a>
>  <h2>1.8 - What is included with OpenBSD?</h2>
> @@ -362,7 +363,7 @@ Of course, additional applications can b
>  <!-- XXXrelease -->
>  
>  The complete list of changes made to OpenBSD 3.9 to create OpenBSD 4.0
> -can be found <a href="../plus40.html">here</a>, however here are a few
> +can be found in the <a href="../plus40.html">OpenBSD 4.0 changes</a> list, 
> however here are a few

Here I personally prefer "... can be found in plus40.html." (with the link
in the obvious place)

(i.e. sometimes the general form "can be found at <a href="xxx">xxx</a>.
works well.  Especially since someone without an active link should be
able to find the target without undue searching - at least, if this
exercise is to be worthwhile).

Keep on with this, though

Many thanks

Tom

Reply via email to