From ce5fe72b4f3940dd83ac6bc7e0e11b02f46bdd4c Mon Sep 17 00:00:00 2001 From: crossley Date: Sat, 16 Nov 2002 12:59:48 +0000 Subject: [PATCH] Initial top-level documentation using Forrest. git-svn-id: https://svn.apache.org/repos/asf/xml/commons/trunk@226016 13f79535-47bb-0310-9956-ffa450edef68 --- forrest.properties | 81 +++++ src/documentation/README.txt | 10 + src/documentation/content/xdocs/book.xml | 25 ++ .../content/xdocs/components/book.xml | 19 ++ .../content/xdocs/components/index.xml | 29 ++ .../content/xdocs/components/resolver.xml | 20 ++ .../content/xdocs/components/which.xml | 20 ++ src/documentation/content/xdocs/history.xml | 239 +++++++++++++++ .../content/xdocs/howto-forrest.xml | 81 +++++ src/documentation/content/xdocs/index.xml | 288 ++++++++++++++++++ src/documentation/content/xdocs/licenses.xml | 108 +++++++ src/documentation/content/xdocs/tabs.xml | 12 + .../resources/images/group-logo.gif | Bin 0 -> 6945 bytes src/documentation/resources/images/icon.png | Bin 0 -> 696 bytes .../resources/images/project-logo.png | Bin 0 -> 2101 bytes src/documentation/skinconf.xml | 90 ++++++ status.xml | 69 +++++ 17 files changed, 1091 insertions(+) create mode 100644 forrest.properties create mode 100644 src/documentation/README.txt create mode 100644 src/documentation/content/xdocs/book.xml create mode 100644 src/documentation/content/xdocs/components/book.xml create mode 100644 src/documentation/content/xdocs/components/index.xml create mode 100644 src/documentation/content/xdocs/components/resolver.xml create mode 100644 src/documentation/content/xdocs/components/which.xml create mode 100644 src/documentation/content/xdocs/history.xml create mode 100644 src/documentation/content/xdocs/howto-forrest.xml create mode 100644 src/documentation/content/xdocs/index.xml create mode 100644 src/documentation/content/xdocs/licenses.xml create mode 100644 src/documentation/content/xdocs/tabs.xml create mode 100644 src/documentation/resources/images/group-logo.gif create mode 100644 src/documentation/resources/images/icon.png create mode 100644 src/documentation/resources/images/project-logo.png create mode 100644 src/documentation/skinconf.xml create mode 100644 status.xml diff --git a/forrest.properties b/forrest.properties new file mode 100644 index 0000000..ce97bb0 --- /dev/null +++ b/forrest.properties @@ -0,0 +1,81 @@ +############## +# Properties used by forrest.build.xml for building the website +############## + +# Prints out a summary of Forrest settings for this project +#forrest.echo=true + +# Project name (used to name .war file) +#project.name=my-project + +# Specifies name of Forrest skin to use +#project.skin=forrest-site +#project.skin=avalon-tigris + + +############## +# layout properties + +# Properties that must be set to override the default locations +#project.status=status.xml +#project.content-dir=src/documentation +#project.conf-dir=${project.content-dir}/conf +#project.sitemap=${project.content-dir}/sitemap.xmap +#project.xdocs-dir=${project.content-dir}/content/xdocs +#project.stylesheets-dir=${project.content-dir}/resources/stylesheets +#project.images-dir=${project.content-dir}/resources/images +#project.schema-dir=${project.content-dir}/resources/schema +#project.skins-dir=${project.content-dir}/skins +#project.skinconf=${project.content-dir}/skinconf.xml +#project.lib-dir=${project.content-dir}/lib +#project.classes-dir=${project.content-dir}/classes + + +############## +# validation properties + +# These props determine if validation is performed at all +# Values are inherited unless overridden. +# Eg, if forrest.validate=false, then all others are false unless set to true. +#forrest.validate=true +#forrest.validate.xdocs=${forrest.validate} +#forrest.validate.skinconf=${forrest.validate} +#forrest.validate.sitemap=${forrest.validate} +#forrest.validate.stylesheets=${forrest.validate} +#forrest.validate.skins=${forrest.validate} +#forrest.validate.skins.stylesheets=${forrest.validate.skins} + + +# Key: +# *.failonerror=(true|false) stop when an XML file is invalid +# *.includes=(pattern) Comma-separated list of path patterns to validate +# *.excludes=(pattern) Comma-separated list of path patterns to not validate + +#forrest.validate.failonerror=true +#forrest.validate.includes=**/* +#forrest.validate.excludes= +# +#forrest.validate.xdocs.failonerror=${forrest.validate.failonerror} +# +#forrest.validate.xdocs.includes=*.x* +#forrest.validate.xdocs.excludes= +# +#forrest.validate.skinconf.includes=${skinconf-file} +#forrest.validate.skinconf.excludes= +#forrest.validate.skinconf.failonerror=${forrest.validate.failonerror} +# +#forrest.validate.sitemap.includes=${sitemap-file} +#forrest.validate.sitemap.excludes= +#forrest.validate.sitemap.failonerror=${forrest.validate.failonerror} +# +#forrest.validate.stylesheets.includes=**/*.xsl +#forrest.validate.stylesheets.excludes= +#forrest.validate.stylesheets.failonerror=${forrest.validate.failonerror} +# +#forrest.validate.skins.includes=**/* +#forrest.validate.skins.excludes=**/*.xsl +#forrest.validate.skins.failonerror=${forrest.validate.failonerror} +# +#forrest.validate.skins.stylesheets.includes=**/*.xsl +#forrest.validate.skins.stylesheets.excludes= +#forrest.validate.skins.stylesheets.failonerror=${forrest.validate.skins.failonerror} diff --git a/src/documentation/README.txt b/src/documentation/README.txt new file mode 100644 index 0000000..4545b58 --- /dev/null +++ b/src/documentation/README.txt @@ -0,0 +1,10 @@ +This is the base documentation directory. It usually contains two files: + +skinconf.xml # This file customizes Forrest for your project. In it, you + # tell forrest the project name, logo, copyright info, etc + +sitemap.xmap # Optional. This sitemap overrides the default one bundled + # with Forrest. Typically, one would copy a sitemap from + # xml-forrest/src/resources/conf/sitemap.xmap, and customize + # it. + diff --git a/src/documentation/content/xdocs/book.xml b/src/documentation/content/xdocs/book.xml new file mode 100644 index 0000000..c205a79 --- /dev/null +++ b/src/documentation/content/xdocs/book.xml @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/content/xdocs/components/book.xml b/src/documentation/content/xdocs/components/book.xml new file mode 100644 index 0000000..1767d0b --- /dev/null +++ b/src/documentation/content/xdocs/components/book.xml @@ -0,0 +1,19 @@ + + + + + + + + + + + + + + + + diff --git a/src/documentation/content/xdocs/components/index.xml b/src/documentation/content/xdocs/components/index.xml new file mode 100644 index 0000000..3433945 --- /dev/null +++ b/src/documentation/content/xdocs/components/index.xml @@ -0,0 +1,29 @@ + + + +
+ Components of xml-commons + + + +
+ + +
+ Overview +

+ These are some of the components that are provided by Apache XML + Commons. +

+
    +
  • Resolver + - ### Fixme: add concise description here. +
    • +
  • Which + - ### Fixme: add concise description here. +
    • +
+
+ + + diff --git a/src/documentation/content/xdocs/components/resolver.xml b/src/documentation/content/xdocs/components/resolver.xml new file mode 100644 index 0000000..49cfe78 --- /dev/null +++ b/src/documentation/content/xdocs/components/resolver.xml @@ -0,0 +1,20 @@ + + + +
+ Resolver + + + +
+ + +
+ Overview +

+ ### Fixme: add overview of Resolver here. +

+
+ + + diff --git a/src/documentation/content/xdocs/components/which.xml b/src/documentation/content/xdocs/components/which.xml new file mode 100644 index 0000000..f1add35 --- /dev/null +++ b/src/documentation/content/xdocs/components/which.xml @@ -0,0 +1,20 @@ + + + +
+ Which + + + +
+ + +
+ Overview +

+ ### Fixme: add overview of Which here. +

+
+ + + diff --git a/src/documentation/content/xdocs/history.xml b/src/documentation/content/xdocs/history.xml new file mode 100644 index 0000000..93adb02 --- /dev/null +++ b/src/documentation/content/xdocs/history.xml @@ -0,0 +1,239 @@ + + + +
+ History of XML Commons + + + +
+ + + +
+ xml-subproject-proposal-commons-v1.1 + +
+ + +
+ xml-subproject-proposal-commons-v1.1-vote-count-26-Apr-01 +

Below follows the votes cast to create this subproject

+

---- From open general@xml.apache.org mailing list through 3pm 26-Apr-01 ---- +

+

Original proposal at: +http://marc.theaimsgroup.com/?l=xml-apache-general&m=987524447023862 +

+

+---- 17 Total committer +1 votes, plus 13 +1's for 4.c (allow all xml +committers) ---- +

+
    +
  • +1 4.c Shane Curcuru curcuru@apache.org (my implicit vote with the proposal)
    • +
  • +1 and 4c Kelly Campbell camk@channelpoint.com
    • +
  • +1 4.c Arnaud Le Hors lehors@us.ibm.com
    • +
  • +1, and 4c Tinny Ng tng-xml@ca.ibm.com
    • +
  • +1, and 4c "Ted Leung" twleung@sauria.com
    • +
  • +1 (4.c) Elena Litani elena@apache.org
    • +
  • +1, 4.c Vincent Hardy vhardy@eng.sun.com
    • +
  • ballot committer="arved" email="asandstrom@accesswave.ca" + vote issue="xml-subproject-proposal-commons-v1.1" vote="+1" + comment/ + /vote + vote issue="xml-subproject-proposal-commons-v1.1-committers" + vote="+1" + comment4.(c)/comment + /vote +/ballot +
    • +
  • +1 and 4c. Andy Clark andyc@apache.org
    • +
  • +1 4.c "Jeffrey Rodriguez" jeffreyr_97@hotmail.com
    • +
  • +1, I vote for the least restrictive option, 4.c. Edwin.Goei@sun.com
    • +
  • +1 for the proposal. +1 for 4.d - all current xml.apache.org and jakarta.apache.org :-) ( but I can settle for 4.c :-) cmanolache@yahoo.com
    • +
  • +1 for 4c Donald_Leslie@lotus.com
    • +
  • +1. Scott Sanders satan@totalsync.com (jakarta committer, don't know if he's an xml committer, but he volunteered to work on coordination with jakarta-commons)
    • +
  • +1, 4.c Thierry Kormann tkormann@sophia.inria.fr
    • +
  • +1 from me. Davanum Srinivas dims@yahoo.com
    • +
  • +1 Scott_Boag@lotus.com
    • +
+
    +
  • ---- Other comments and non-committer votes ----
    • +
  • ballot committer="" email="shugal@gmx.de" + vote issue="xml-subproject-proposal-commons-v1.1" vote="+1" + commentA good and necessary idea! I'd like to contribute here. + Also see below./comment + /vote + vote issue="xml-subproject-proposal-commons-v1.1-committers" + vote="4.b or 4.a" + commentI'm no committer, but I think we should get the + number of committers low at least a this initial stage. Everyone is + free to contribute code to one of the actual committers who will + check it into CVS if they think it's useful./comment + /vote +/ballot +
    • +
  • "Once the /xml-commons repository is set up, I volunteer to check in the +latest JAXP code into /xml-commons. Right now there are 3 different +projects with 3 different versions. It'd be nice to have just one." Edwin +Goei edwingo@sun.com +
    • +
+

/xml-subproject-proposal-commons-v1.1-vote-count-26-Apr-01

+
+ + diff --git a/src/documentation/content/xdocs/howto-forrest.xml b/src/documentation/content/xdocs/howto-forrest.xml new file mode 100644 index 0000000..ff3709c --- /dev/null +++ b/src/documentation/content/xdocs/howto-forrest.xml @@ -0,0 +1,81 @@ + + + +
+ How to produce xml-commons website with Forrest + + + +
+ +
+ Overview +

+This is the procedure that i followed to build the initial xml-commons +website with Forrest. +

+ +This is just to get us started. Later Forrest will automatically build it. + +
+ +
+ Install Forrest on localhost +

+ Followed the document: + Using + Forrest +

+
+ +
+ Seed the new website +

+ This only needed to be done to start and it is done now and committed + to CVS. +

+ +
+ +
+ Edit the content + +
+ +
+ Build it and view it + +
+ +
+ Still to do +
    +
  • Ensure okay by the xml-commons team. +See temporary demo at +http://cvs.apache.org/~crossley/commons/ +
    • +
  • Synchronise changes with any to README.html until we are in production
    • +
  • Commit src/documentation/* to xml-commons CVS
    • +
  • Commit the HTML/PDF result to xml-site/targets CVS
    • +
  • Add link to xml.apache.org/index.html
    • +
  • Later get Forrest to automatically build our website by extracting sources +from CVS. This will later be done as a batch process, along with other Apache +websites. For the time being, an xml-commons committer needs to manually do it. +
    • +
+
+ + diff --git a/src/documentation/content/xdocs/index.xml b/src/documentation/content/xdocs/index.xml new file mode 100644 index 0000000..2784dee --- /dev/null +++ b/src/documentation/content/xdocs/index.xml @@ -0,0 +1,288 @@ + + + +
+ Welcome to xml-commons + + + +
+ + +
+ Overview +

xml-commons is focussed on common code and guidelines for xml projects. +The first focus will be to organize and have common packaging for the various +externally-defined standards code relating to XML - things like the DOM, SAX, +and JAXP interfaces.

+

As the xml-commons community forms, we also hope to serve as a holding area +for other common xml-related utilities and code, and to help promulgate common +packaging, testing, documentation, and other guidelines across all +xml.apache.org subprojects.

+
+ + +
+ Commons Guidelines +

As the community forms, we need to formalize these guidelines, especially +to differentiate "requirements" from suggested "guidelines".

+

Shane's starting proposals:

+

xml-commons is an unusual project in several ways.

+

First, it encompasses two kinds of code: External and Apache.

+

Secondly, +xml-commons mainly focuses on providing code and services to other +xml.apache.org projects instead of shipping it's own 'standalone' project. +

+

Third, it will also tend to be more focussed on smaller, interoperable modules of +code and a very high degree of stability.

+

In some ways, the forming of +xml-commons is the seed of a catalyst to improve cross-project coordination +throughout xml.apache.org. One potential goal is to get all xml.apache.org +projects to take their xml standards oriented code - like DOM, SAX and JAXP - +from specific marked builds of xml-commons, instead of each project +using different versions of these files.

+

External code: xml-commons will serve as an Apache-controlled +copy of externally-defined standards-based files. This way, we can try +to manage common versions of these important xml standards-based files +and interfaces. Read more.

+

Apache code: xml-commons will serve as a shared repository for +common xml-oriented utilities or building blocks that several other +xml.apache.org projects wish to use. The first example is org.apache.env.Which, +and environment checking utility that scans your environment and reports common +versions of xml-related files. The next likely submission is an entity resolver +that could be plugged into any xml parsing, transforming, or processing +project. Read more.

+

Directory tree (proposed)

+ +This needs to be updated to reflect the current tree. +It also needs to go into a section of its own or perhaps a separate document. + + + +
    +
  • We should consider adopting those guidelines from the jakarta-commons +project that make sense for our xml projects - keeping in mind that both the kind of +projects we build are different than jakarta, and some of our goals are a +little bit different.
    • +
  • Dicsussion and buy-in should happen on the project mailing list +before checking in new modules.
    • +
  • New modules generally shouldn't go in until at least two separate +other projects express interest in using the module. I think this is an +important difference from jakarta-commons that makes sense in our world. +I.e. I'd rather not just throw something in because it seems like it might +be useful, I'd rather only put things in that we know will be shared among +multiple projects.
    • +
  • The xml-commons community should come up with guidelines for other +xml.apache.org subprojects to use the code that commons has. I.e. suggestions +and ways to package this code vis-a-vis the other project's code in a common way.
    • +
  • Other shared xml.apache.org guidelines? Like documentation format, testing techniques/policies, etc.
    • +
+
+ + +
+ External code: DOM, SAX, and JAXP, etc. +

xml-commons primary goal is to provide Apache projects with a stable version of +XMl-related externally-defined standards-based code. This is mainly the various +interfaces that you use when programming XML from JAVA: DOM, SAX and JAXP for now.

+

This tree is rooted at xml-commons/java/external, and has a build.xml file. +Basic documentation from each external project is also checked in.

+
    +
  • Current (Feb-02) status:
    • +
  • No significant changes from Jan-02
    • +
  • Current (Jan-02) status:
    • +
  • DOM L2 - full set of interfaces (including HTML stuff) from w3c.org
    • +
  • SAX 2.0 from megginson.com, plus minor bugfixes. Note that SAX +is currently maintained at +http://sax.sourceforge.net/ +( we need to update and cross-check with them soon!)
    • +
  • JAXP 1.1.3-HEAD from Sun, with current bugfixes by edwingo@apache.org
    • +
+

Issues Jan-02: our current SAX and JAXP code may not pass the current +J2EE CTS test suite, since we have bugfixes above what those CTS tests +mandate. If you don't know what that is, you don't care; otherwise ask +on commons-dev for an update.

+
+ + +
+ Apache-authored code +

xml-commons' secondary goal is to provide a project space for small +XML-related utilities that are being used in multiple other xml.apache.org +projects. In an effort to simplify and reduce dependency headaches, we'll +probably accept new projects only fairly slowly (this is in contrast to +the much more open +jakarta-commons project). +In particular, code submitted here should probably have minimal dependencies: +possibly only depending on DOM/SAX/JAXP and Ant (for builds).

+
    +
  • Current (Nov-02) status:
    • +
  • org.apache.xml.resolver.Resolver: Norm Walsh's entity resolver utility now released +as a separate distribution, see Releases.
    • +
  • Current (Feb-02) status:
    • +
  • org.apache.env.Which - a simple environment check utility for +xml-related items in your JVM's environment: see xml-commons/java/which.xml
  • org.apache.xml.resolver.Resolver: Norm Walsh's entity resolver utility now checked in!
    • +
  • (to be voted in) Jeff Turner's DOCTYPE changer
    • +
  • Current (Jan-02) status:
    • +
  • org.apache.env.Which - a simple environment check utility for +xml-related items in your JVM's environment: see xml-commons/java/which.xml
  • (to be submitted) Norm Walsh's entity resolver utility
    • +
  • (to be voted in) Jeff Turner's DOCTYPE changer
    • +
+
+ + +
+ Where can I download releases? +

The xml-commons-resolver-1.0 release 12-Nov-02 is available in our +distribution directory +and includes: +

+
    +
  • This release is includes just the 1.0 XmlResolver component, by request from coccoon-dev and others. +It is released for users who just want to use the Resolver and don't need the rest +of xml-commons. Pending discussion on commons-dev, we believe that future xml-commons +releases will be separated out in this manner (external/resolver/which/etc).
    • +
+ +

The xml-commons-1.0.b2 release 06-Feb-02 is available in our +distribution directory +and includes: +

+
    +
  • The previous contents from the 1.0.b1 release (minor javadoc fixes may have been made)
    • +
  • Various LICENSE.* and README.* files for our external sources
    • +
  • New code! org.apache.xml.resolver.Resolver: Norm Walsh's entity resolver utility +is now checked in and building!
    • +
+ +

The xml-commons-1.0.b1 release 11-Jan-02 is available in our +distribution directory +and includes the following code: +

+
    +
  • java/build/which.jar containing:
    • +
  • org.apache.env.Which - a simple environment check utility for +xml-related items in your JVM's environment: 1.0 funtionality working
    • +
  • java/external/build/xml-apis.jar containing:
    • +
  • DOM Level 2 including all base files and HTML and CSS DOMs; from +w3c.org
    • +
  • JAXP code roughly equivalent to JAXP 1.1.3; for reference releases +from Sun, see +java.sun.com/xml
    • +
  • SAX 2.0-r2-prerelease and SAX2-ext-1.0; plus bugfixes to +org.xml.sax.helpers.ParserAdapter (make compile in JDK 1.1.x) and AttributesImpl (minor +removeAttribute bug); from megginson.com although SAX maintenance has +now moved to +sax.sourceforge.net
    • +
+ +

Future 'b' or beta releases leading up to a gold 1.0 release will +be discussed on our mailing list. Likely releases +might address points such as: +

+
    +
  • Improvements or submissions to org.apache.env.Which
    • +
  • A new submission of an entity resolver from Norman Walsh
    • +
  • A specific version of backlevel JAXP 1.1 that will work with +Sun's J2EE CTS conformance tests, if enough people request it
    • +
  • Specific versions of SAX, if the xml.apache.org community +requests it and wants to update to a newer shipped release of SAX, perhaps +SAX 2R2pre3 or later
    • +
+
+ + +
+ How can I find out more? +

We have a project mailing list ... commons-dev<at>xml.apache.org +... Ask your questions or bring your suggestions there, +or to general<at>xml.apache.org +

+
    +
  • Send an email to commons-dev +... commons-dev<at>xml.apache.org
    • +
  • Subscribe to commons-dev +... commons-dev-subscribe<at>xml.apache.org
    • +
  • Un-subscribe from commons-dev +... commons-dev-unsubscribe<at>xml.apache.org
    • +
+
+ + +
+ Where can I get the code/CVS? +

The xml-commons repository is available thru normal and anonymous CVS, or +through this +nifty web +interface.

+

See +xml.apache.org CVS overview. +

+
+ + +
+ History +

See the separate document History of XML Commons +for the proposal to establish the xml-commons project and for the record of the +vote on 2001-04-26. +

+
+ + +
+ Licenses +

+See information about licensing. +

+
+ + +
+ Information about this document +
    +
  • Version: $Id$
    • +
  • This document is stored in the xml-commons CVS repository as: +/home/cvs/xml-commons/src/documentation/content/xdocs/index.xml +
    • +
  • +The HTML and PDF renditions are generated by +Apache Forrest +
    • +
+
+ + diff --git a/src/documentation/content/xdocs/licenses.xml b/src/documentation/content/xdocs/licenses.xml new file mode 100644 index 0000000..2e486de --- /dev/null +++ b/src/documentation/content/xdocs/licenses.xml @@ -0,0 +1,108 @@ + + + +
+ Licenses for xml-commons + + + +
+ +
+ HEAR YE, HEAR YE! +

+Software and documentation in this repository are covered under +a number of different licenses. +

+ +

+Most files under xml-commons/java/external/ are covered +under their respective LICENSE.*.txt files; see the matching +README.*.txt files for descriptions. +

+ +

+Note that xml-commons/java/external/build.xml and +xml-commons/java/external/src/manifest.commons are +both covered under the Apache Software License. +

+ +

+All files not otherwise noted are covered under the +Apache Software License in LICENSE.txt including all +files under xml-commons/java/src +

+
+ + +
+ General License +. + */ +]]> +
+ + +
+ Information about this document +
    +
  • Version: $Id$
    • +
+
+ + diff --git a/src/documentation/content/xdocs/tabs.xml b/src/documentation/content/xdocs/tabs.xml new file mode 100644 index 0000000..01c0ec6 --- /dev/null +++ b/src/documentation/content/xdocs/tabs.xml @@ -0,0 +1,12 @@ + + + + + + + + + diff --git a/src/documentation/resources/images/group-logo.gif b/src/documentation/resources/images/group-logo.gif new file mode 100644 index 0000000000000000000000000000000000000000..57e4b36a16e071d0141f657e3820de361e2d0f03 GIT binary patch literal 6945 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 E0B2`!4*&oF literal 0 HcmV?d00001 diff --git a/src/documentation/resources/images/icon.png b/src/documentation/resources/images/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..3be8bbbe65c73bfdd555f521844f5e343d789954 GIT binary patch literal 696 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 Tx(Q`&zymC=*qT+FdL;b~6XWu; literal 0 HcmV?d00001 diff --git a/src/documentation/skinconf.xml b/src/documentation/skinconf.xml new file mode 100644 index 0000000..22061a1 --- /dev/null +++ b/src/documentation/skinconf.xml @@ -0,0 +1,90 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ]> + + + + false + xml.apache.org + Apache XML + + + xml-commons + http://xml.apache.org/xml-commons/ + images/project-logo.png + + + Apache XML + http://xml.apache.org/ + images/group-logo.gif + + + + + + + 2002 + The Apache Software Foundation. + + + + + + + + + + + + Built with Apache Forrest + http://xml.apache.org/forrest/ + images/built-with-forrest-button.png + 88 + 31 + + + diff --git a/status.xml b/status.xml new file mode 100644 index 0000000..3777493 --- /dev/null +++ b/status.xml @@ -0,0 +1,69 @@ + + + + + + + + + + + + + + + Finish initial website. Follow procedure in + How-to Forrest + + + Tweak the initial content for the top-level docs. + + + Decide how to build separate distributable docs for each "component", + and how they will also be published to xml-commons website. Best if + xdocs content can remain in /java with their code. See email: + draft website for xml-commons using Forrest + + + + + Add top-level documents about each resource that is provided by + xml-commons. + + + Decide directory layout. See email: + Repository layout + + + Replace the README file at + http://xml.apache.org/commons/dist/ + + + + + + + + + + + Added placeholder docs and tabs for components. + + + + + + Built demo website using Forrest. Gleaned content from + xml-commons/README.html + + + +