Author: rbowen
Date: Sun Oct 27 15:05:20 2024
New Revision: 1921596
URL: http://svn.apache.org/viewvc?rev=1921596&view=rev
Log:
Make this page sound less like ancient history, and more like an active tool.
Modified:
comdev/projects.apache.org/trunk/site/doap.html
Modified: comdev/projects.apache.org/trunk/site/doap.html
URL:
http://svn.apache.org/viewvc/comdev/projects.apache.org/trunk/site/doap.html?rev=1921596&r1=1921595&r2=1921596&view=diff
==============================================================================
--- comdev/projects.apache.org/trunk/site/doap.html (original)
+++ comdev/projects.apache.org/trunk/site/doap.html Sun Oct 27 15:05:20 2024
@@ -33,19 +33,27 @@
<h2>DOAP Files</h2>
<div>
-<p>During October 2005 a wide ranging discussion was held on the site-dev
mailing list aimed at arriving at an archictecture and tools that would allow
us to create a project directory web site. A key part of the plans, and one of
the biggest stumbling blocks, was the selection of a suitable format of
information file that would be the key part.</p>
-<p>The result of the discussion was a consensus to use <a
href="https://github.com/edumbill/doap/wiki";>DOAP</a> - "Description Of A
Project" which is an RDF based format. The decision was taken for the following
reasons:</p>
-<ul>
-<li>use of an existing format was felt to be important</li>
-<li>it is becoming more commonly used and therefore has a growing base of
support</li>
-<li>being designed to be extensible it can be easily adjusted to our needs</li>
-</ul>
-<p>This site is generated from DOAP files that each project maintains
individually. If a project hasn't provided a link to their DOAP file, it won't
appear on this site. If the project you're interested in isn't here, go tell
them to create a DOAP file and get themselves listed!</p>
-<p>This section of the website contains advice and guidelines for projects
when creating or maintaining their DOAP files. While much of the information
contained is general to all DOAP files, some is specific to the files
maintained by ASF projects.</p>
+<p>DOAP (Description Of A Project) is a RDF (XML) based format which
+describes important aspects of a project. By creating a DOAP file for
+your project, you can provide essential details about your project which
+can then be presented to various audiences in various formats, along
+with information about other ASF projects.</p>
+
+<p>The result of the discussion was a consensus to use
+- "Description Of A Project" which is an RDF based format. The decision was
taken for the following reasons:</p>
+
+<p>This site (<a href="https://projects.apache.org/";>projects.apache.org</a>)
+is generated from DOAP files that each project maintains individually. If a
+project hasn't provided a link to their DOAP file, it won't appear on this
site.
+If the project you're interested in isn't here, send them a link to this page,
+and tell them to create a DOAP file to get themselves listed!</p>
+
+<h4>More info</h4>
<ul>
-<li>DOAP <a href="guidelines.html">Guidelines</a></li>
-<li><a href="create.html">Create</a> an ASF DOAP</li>
-<li>DOAP <a href="doapfaq.html">FAQ</a></li>
+<li><a href="guidelines.html">Guidelines for creating an ASF DOAP file</a></li>
+<li><a href="create.html">Create an ASF DOAP</a> (Form-based wizard)</li>
+<li><a href="doapfaq.html">DOAP FAQ</a></li>
+<li><a href="https://github.com/edumbill/doap/wiki";>Read more about the DOAP
format</a></li>
</ul>
</div>
