Add text about default assignees and common assignees (specifically
to address the continuing confusion about assigning to mailing lists
vs. assigning to aliases).
Add more text about how misfiled PRs occur.
Add more text about how to kill spam PRs.
Discussed on: freebsd-doc
Reviewed by: mheinen, ceri
Currently we have articles.ent and books.ent, and
for example, articles.ent can be used by putting the
following lines in the doctype declaration:
<!ENTITY % articles.ent PUBLIC
"-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
%articles.ent;
This pulls all of the necessary entities via share/sgml/articles.ent.
The translation teams can customize these entities by redefining
the articles.ent file in <langcode>/share/sgml. See
ja_JP.eucJP/share/sgml for example.
- Add trademark tags as needed, generally on first use in each
article.
- Add an attribution to the legal section mentioning all trademarks
referenced.
- Always use correct case for trademarks.
comments on their handling).
. Add references to the mailing list entities and use them in the text.
. Add id="foo" keywords to the sections of the article to make links
other people make to parts of the article less prone to breaking.
enable it in en_US.ISO8859-1/ and ja_JP.eucJP/.
- Add PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN"
and l10n.ent for entity localization.
- Use share/misc/docbook.css for indentiation of <programlisting>
and <screen>.
- Add some missing $FreeBSD$.
