Bug 156771 - fedora-entities-en.xml: Incorrect entity declarations, addition of example entities
fedora-entities-en.xml: Incorrect entity declarations, addition of example en...
Product: Fedora Documentation
Classification: Fedora
Component: docs-requests (Show other bugs)
All Linux
medium Severity medium
: ---
: ---
Assigned To: Karsten Wade
Mark Johnson
: FutureFeature
: 156770 (view as bug list)
Depends On:
  Show dependency treegraph
Reported: 2005-05-04 02:41 EDT by Thomas Jones
Modified: 2009-07-07 00:09 EDT (History)
1 user (show)

See Also:
Fixed In Version:
Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2005-07-18 22:14:27 EDT
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)
diff -u fedora-entities-en.xml.orig fedora-entities-en.xml > fedora-entities-en.xml.diff (15.34 KB, patch)
2005-05-04 02:41 EDT, Thomas Jones
no flags Details | Diff

  None (edit)
Description Thomas Jones 2005-05-04 02:41:41 EDT
Description of problem:
Various entities were incorrectly constructed. Most were missing copyright

I've added a grouping of example entities for user,host, and/or network specific

Some "open" issues still exist and have been posted to the mailinglist for review.
Comment 1 Thomas Jones 2005-05-04 02:41:41 EDT
Created attachment 113996 [details]
 diff -u fedora-entities-en.xml.orig fedora-entities-en.xml > fedora-entities-en.xml.diff
Comment 2 Thomas Jones 2005-05-04 02:48:06 EDT
*** Bug 156770 has been marked as a duplicate of this bug. ***
Comment 3 Thomas Jones 2005-05-04 11:37:26 EDT
OOPS! Line 134 comment should be changed to read:
<!-- Example POP3 server fqdn: pop3.redhat.local -->
Comment 4 Paul W. Frields 2005-05-04 14:16:49 EDT
I'd like to make a couple suggestions:

1. Change the example domains.  Refer to RFC 2606
(http://www.faqs.org/rfcs/rfc2606.html) for additional information.  A
suggestion might be "fedora.example."  Do not use the name Red Hat, since it
might imply an unnecessary corporate link.  Additional domains might be
"core.example" or "mydomain.example."

2. Drop the Buddhism-inspired names.  Some readers may object to their usage,
and therefore these entity names violate style guidelines.  Use the
neutral-toned "station{1,2,3...}", "node{1,2,3...}", or some other equally
generic term.

3. No SMILEY entity is needed, since its use also would break style rules.
Comment 5 Karsten Wade 2005-05-04 14:42:52 EDT
These look really good.  Thanks for cleaning up the file and thinking the
entities through.

I don't think we need to emphasize or keep Red Hat specific entities.  I think
their presence is related to the boilerplate page.

When it comes to trademarks, we don't need to note them with every usage.  In
fact, we have permission to put a blanket statement in the boilerplate, "All
other trademarks are the property of their respective owners," or somesuch, and
we should be fine.  I've been meaning to make that change for a while.

Have trademarks all over a doc is not a pretty sight. :)

I agree with Paul's comments (#4).

I'll address some open issues on the mailing list.
Comment 6 eric@christensenplace.us 2009-07-07 00:09:01 EDT
Ticket moved to allow products to be removed from BZ.

Note You need to log in before you can comment on or make changes to this bug.