krb5 commit: New section: Contributing to Kerb documentation
Zhanna A Tsitkova
tsitkova at MIT.EDU
Thu Jan 31 11:55:04 EST 2013
https://github.com/krb5/krb5/commit/fedba8d99e616de74129b64f619990150eb334bb
commit fedba8d99e616de74129b64f619990150eb334bb
Author: Zhanna Tsitkov <tsitkova at mit.edu>
Date: Thu Jan 31 11:39:44 2013 -0500
New section: Contributing to Kerb documentation
doc/about.rst | 31 +++++++++++++++++--------------
1 files changed, 17 insertions(+), 14 deletions(-)
diff --git a/doc/about.rst b/doc/about.rst
index d36acdb..904f612 100644
--- a/doc/about.rst
+++ b/doc/about.rst
@@ -1,5 +1,18 @@
-The Kerberos Documentation Set
-==============================
+Contributing to the MIT Kerberos Documentation
+==============================================
+
+We are looking for documentation writers and editors who could contribute
+towards improving the MIT KC documentation content. If you are an experienced
+Kerberos developer and/or administrator, please consider sharing your knowledge
+and experience with the Kerberos Community. You can suggest your own topic or
+write about any of the topics listed
+`here <http://k5wiki.kerberos.org/wiki/Projects/Documentation_Tasks>`__.
+
+If you have any questions, comments, or suggestions on the existing documents,
+please send your feedback via email to krb5-bugs at mit.edu. The HTML version of
+this documentation has a "FEEDBACK" link to the krb5-bugs at mit.edu email
+address with a pre-constructed subject line.
+
Background
----------
@@ -8,8 +21,8 @@ Starting with release 1.11, the Kerberos documentation set is
unified in a central form. Man pages, HTML documentation, and PDF
documents are compiled from reStructuredText sources, and the application
developer documentation incorporates Doxygen markup from the source
-tree. This project was undertaken along the outline described at
-http://k5wiki.kerberos.org/wiki/Projects/Kerberos_Documentation .
+tree. This project was undertaken along the outline described
+`here <http://k5wiki.kerberos.org/wiki/Projects/Kerberos_Documentation>`__.
Previous versions of Kerberos 5 attempted to maintain separate documentation
in the texinfo format, with separate groff manual pages. Having the API
@@ -20,13 +33,3 @@ easier to use and maintain, reStructuredText-based documents should provide
an improved experience for the user. Consolidating all the documentation
formats into a single source document makes the documentation set easier
to maintain.
-
-Feedback and Comments
----------------------
-
-At the moment, comments should be sent via email to
-krb5-bugs at mit.edu.
-
-The HTML version of this documentation has a "FEEDBACK" link
-(at the bottom of every page) to the krb5-bugs at mit.edu email address
-with a pre-constructed subject line.
More information about the cvs-krb5
mailing list