non-releases/trunk_before_flattening/src/documentation/src/content/xdocs/c21-doc-plan/content_en.html - cocoon - Git at Google

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>About the Cocoon Documentation Effort</title>
 <link href="http://purl.org/DC/elements/1.0/" rel="schema.DC">
 <meta content="Overview" name="DC.Subject">
 <meta content="David Crossley" name="DC.Creator">
 <meta content="Diana Shannon" name="DC.Creator">
 </head>
 <body>

 <h1>Overview</h1>


 <p>
 There is a concerted effort underway at this time to improve Cocoon's documentation. This effort is based on the belief that open source documents can be as first-rate as the software on which they are based. However, such an endeavor is entirely dependent upon vital and timely forms of contributions from developers and users alike. Make no mistake about it; everyone is needed and invited to participate in this effort!
   </p>

 <p>
 While we have a lot to do, there are evolving structures in place to facilitate and enhance your efforts. We have numerous guidelines for authoring documents, a document-specific email list, and a complementary documentation architectural project at <a class="external" href="http://xml.apache.org/forrest/">Forrest</a>. If you choose to become involved, you will discover many like-minded developers and users who care about Cocoon documentation and will support your effort. Here are a few ideas to help you get started.
   </p>


 <h2>Cocoon Docs List</h2>
 <p>
 Find out what documentation efforts are already in process among other users
 and committers. Consider joining the
 cocoon-docs <a class="external" href="http://cocoon.apache.org/community/mail-lists.html">mailing list</a>.
 </p>


 <h2>Forms of Document Contributions</h2>
 <p>
 Check out Cocoon's How-To guidelines to learn about the variety of ways to contribute or improve Cocoon documents.
   </p>
 <ul>

 <li>
 <a href="../howto/howto-author-faq.html">How to Author an FAQ</a>
 </li>

 <li>
 <a href="../howto/howto-author-howto.html">How to Author a How-To</a>
 </li>

 <li>
 <a href="../howto/howto-author-snippet.html">How to Author a Code Snippet</a>
 </li>

 <li>
 <a href="../howto/howto-author-core-docs.html">How to Author Core Documentation</a>
 </li>

 </ul>


 <h2>Cocoon Wikis</h2>
 <p>
 Cocoon has two promising and complementary wiki efforts underway.
 </p>
 <ul>

 <li>

 <a class="external" href="http://wiki.apache.org/cocoon/">Cocoon Wiki</a> focuses on content development for the Cocoon project. It is designed to facilitate document development and collaboration from all levels of Cocoon users. Documents include FAQs, snippets, how-tos, tutorials, RTs (random thoughts), dreams, surveys, and more. The preliminary focus of this the wiki is to serve as a documentation "breeding ground," where docs can "grow" until mature enough to become official cvs docs. However, it already represents a lively and valid document resource in its own right.
   </li>

 <li>

 <a class="external" href="http://www.anyware-tech.com/wikiland/">Wikiland</a> is an ongoing development effort to build a Cocoon-based wiki architecture. Wikiland features a Cocoon dictionary as the pretext to use, test and develop the wiki. The project is seeking Cocoon-oriented developers to further its development. For more information, see the <a class="external" href="http://rossel.free.fr/">Wikiland home page.</a>

 </li>

 </ul>


 <h2>Other Information</h2>
 <p>
 If you're interested in reviewing recent documentation additions or substantive modifications, see the documentation <a href="changes-doc.html"> History of Changes</a>. You may also want to check out the documentation-specific <a href="todo-doc.html">To-Do List</a>. You can also take an advance look at a proposed <a href="proposed-toc.html">table of contents</a> for a revised Cocoon guide. You may also be interested in reviewing some <a href="issues-doc.html">general and specific issues</a> related to Cocoon documentation. Your comments and feedback on any of the above are welcome on the cocoon-docs list.
   </p>


 </body>
 </html>
	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	<html>
	<head>
	<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<title>About the Cocoon Documentation Effort</title>
	<link href="http://purl.org/DC/elements/1.0/" rel="schema.DC">
	<meta content="Overview" name="DC.Subject">
	<meta content="David Crossley" name="DC.Creator">
	<meta content="Diana Shannon" name="DC.Creator">
	</head>
	<body>

	<h1>Overview</h1>


	<p>
	There is a concerted effort underway at this time to improve Cocoon's documentation. This effort is based on the belief that open source documents can be as first-rate as the software on which they are based. However, such an endeavor is entirely dependent upon vital and timely forms of contributions from developers and users alike. Make no mistake about it; everyone is needed and invited to participate in this effort!
	</p>

	<p>
	While we have a lot to do, there are evolving structures in place to facilitate and enhance your efforts. We have numerous guidelines for authoring documents, a document-specific email list, and a complementary documentation architectural project at <a class="external" href="http://xml.apache.org/forrest/">Forrest</a>. If you choose to become involved, you will discover many like-minded developers and users who care about Cocoon documentation and will support your effort. Here are a few ideas to help you get started.
	</p>


	<h2>Cocoon Docs List</h2>
	<p>
	Find out what documentation efforts are already in process among other users
	and committers. Consider joining the
	cocoon-docs <a class="external" href="http://cocoon.apache.org/community/mail-lists.html">mailing list</a>.
	</p>


	<h2>Forms of Document Contributions</h2>
	<p>
	Check out Cocoon's How-To guidelines to learn about the variety of ways to contribute or improve Cocoon documents.
	</p>
	<ul>

	<li>
	<a href="../howto/howto-author-faq.html">How to Author an FAQ</a>
	</li>

	<li>
	<a href="../howto/howto-author-howto.html">How to Author a How-To</a>
	</li>

	<li>
	<a href="../howto/howto-author-snippet.html">How to Author a Code Snippet</a>
	</li>

	<li>
	<a href="../howto/howto-author-core-docs.html">How to Author Core Documentation</a>
	</li>

	</ul>


	<h2>Cocoon Wikis</h2>
	<p>
	Cocoon has two promising and complementary wiki efforts underway.
	</p>
	<ul>

	<li>

	<a class="external" href="http://wiki.apache.org/cocoon/">Cocoon Wiki</a> focuses on content development for the Cocoon project. It is designed to facilitate document development and collaboration from all levels of Cocoon users. Documents include FAQs, snippets, how-tos, tutorials, RTs (random thoughts), dreams, surveys, and more. The preliminary focus of this the wiki is to serve as a documentation "breeding ground," where docs can "grow" until mature enough to become official cvs docs. However, it already represents a lively and valid document resource in its own right.
	</li>

	<li>

	<a class="external" href="http://www.anyware-tech.com/wikiland/">Wikiland</a> is an ongoing development effort to build a Cocoon-based wiki architecture. Wikiland features a Cocoon dictionary as the pretext to use, test and develop the wiki. The project is seeking Cocoon-oriented developers to further its development. For more information, see the <a class="external" href="http://rossel.free.fr/">Wikiland home page.</a>

	</li>

	</ul>


	<h2>Other Information</h2>
	<p>
	If you're interested in reviewing recent documentation additions or substantive modifications, see the documentation <a href="changes-doc.html"> History of Changes</a>. You may also want to check out the documentation-specific <a href="todo-doc.html">To-Do List</a>. You can also take an advance look at a proposed <a href="proposed-toc.html">table of contents</a> for a revised Cocoon guide. You may also be interested in reviewing some <a href="issues-doc.html">general and specific issues</a> related to Cocoon documentation. Your comments and feedback on any of the above are welcome on the cocoon-docs list.
	</p>






	</body>
	</html>