draft notice text

Paul W. Frields paul at frields.com
Wed Sep 15 22:19:15 UTC 2004


On Wed, 2004-09-15 at 17:38, Mark Johnson wrote:
> Brock Organ wrote:
> > On Wed, 2004-09-15 at 16:52 -0400, Tammy Fox wrote:
> > 
> >>I was about to add the common draft notice file from bug #132415, but I
> >>wanted to discuss the wording of the notice a bit more. (This was
> >>discussed on the Hardening Doc Preview thread, but I am starting a new
> >>one with a more appropriate subject.)
> >>
> >>Thoughts?
> > 
> > 
> > sounds good to me ...
> 
> Me, too. A nice improvement:)

I also like this!

>  > Then, in the parent file, the entity &BUG-NUM; would a link to the
>  > Bugzilla entry for that document.
> 
> We may not want the &BUG-NUM; entity to show the full URL if it's 
> one of those horrendously long, page-wrapping bugzilla URLs. If 
> that's indeed the case, we may want the entity to contain a complete 
> ulink element with link text that is literally the bugzilla bug 
> number. ('just thinking out loud here...)

The URL <http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=######>
always works in my experience (for non-restricted bugs of course). If
the writer uses too long a URL, the editor can fix it without a problem.

Or for that matter, I suppose we could have a common entity:

<!ENTITY SYSTEM BZ-Q
"http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=">

And in the writer's doc:

<!ENTITY SYSTEM BUG-URL "&BZ-Q;######">

But maybe that's just too much work? Not sure.

-- 
Paul W. Frields, RHCE





More information about the fedora-docs-list mailing list