Until we are comfortable with Confluence being both site and wiki,
I think maintaining the site is important.
FYI, the manual is also linked to from http://cwiki.apache.org/
openjpa/documentation.html
Even if we ever go to Confluence for the whole site, I think we'll
still need to maintain the existing space for raw HTML (like the docs/
javadocs), since AFAIK there is no way to bulk-import raw HTML pages
into Confluence spaces.
On Oct 15, 2006, at 12:42 PM, Craig L Russell wrote:
Hi Marc,
On Oct 14, 2006, at 11:11 PM, Marc Prud'hommeaux wrote:
I've gone ahead and checked in the OpenJPA manual so it is
available at:
http://incubator.apache.org/openjpa/docs/openjpa-0.9.0-
incubating/manual/manual.html
This is good, being linked from the navbar on the site.
Until we are comfortable with Confluence being both site and wiki,
I think maintaining the site is important.
Craig
On Oct 14, 2006, at 6:13 PM, Craig L Russell wrote:
More detail.
It's not too hard to add html stuff to the site, as long as there
is some anchor for them. See http://incubator.apache.org/openjpa/
javadoc.html as an example.
The only issue is making sure folks can get to them, and that we
know how to build them and make them available.
It might be ok if only the latest release of the html manual was
available via the site. If the docs are built from sources in the
trunk, when you make a branch for release, then the manual is
also branched and any updates in the trunk will be reflected in
the site docs. The users who wanted manuals from the branch would
need to have instructions on how to build them for their use.
You might look at other Apache (e.g. Derby) projects for how they
handle this.
Craig
On Oct 14, 2006, at 5:27 PM, Craig L Russell wrote:
Hi Marc,
I've added the javadocs (from August; see OPENJPA-11) to the
site, not the wiki.
These might need an update at some point but they are probably
90% there.
The manual stuff should probably go onto the site as well.
Craig
On Oct 13, 2006, at 2:45 PM, Marc Prud'hommeaux wrote:
All-
I would like to upload the OpenJPA docs and javadocs for the
0.9.0-incubating to a more official location than the
information place where they currently result (http://
people.apache.org/~mprudhom/openjpa/site/openjpa-project/manual/
index.html).
Does anyone have any recommendations for where they should be
put? Should I check them into the svn repository that is the
source for http://incubator.apache.org/openjpa/ , or should I
try to convert them into the wiki at http://cwiki.apache.org/
openjpa/ , or somewhere else?
Craig Russell
Architect, Sun Java Enterprise System http://java.sun.com/
products/jdo
408 276-5638 mailto:[EMAIL PROTECTED]
P.S. A good JDO? O, Gasp!
Craig Russell
Architect, Sun Java Enterprise System http://java.sun.com/
products/jdo
408 276-5638 mailto:[EMAIL PROTECTED]
P.S. A good JDO? O, Gasp!
Craig Russell
Architect, Sun Java Enterprise System http://java.sun.com/products/jdo
408 276-5638 mailto:[EMAIL PROTECTED]
P.S. A good JDO? O, Gasp!
