...
The Apache Geronimo project used cwiki.apache.org as it's wiki and primary documentation. This wiki is based on Confluence.
...
The entry point to Geronimo's wiki is http://cwiki.apache.org/geronimo , this is the first and most importance space. Although it has just a very few documents there it is the backbone of all the other spaces, from there you can navigate throughout all the documentation, no matter what space that document is in.
...
Space name | Space Key | Purpose | |||
---|---|---|---|---|---|
Apache Geronimo Documentation | geronimo | Backbone of the entire Geronimo wiki. It provides navigational organization to the remaining spaces. | |||
Apache Geronimo v2.2 | GMOxDOC22 | Home for the Apache Geronimo v2.2 documentation. | |||
Apache Geronimo v2.1 | GMOxDOC21 | Home for the Apache Geronimo v2.1 documentation. | |||
Apache Geronimo v2.0 | GMOxDOC20 | Home for the Apache Geronimo v2.0 documentation. | |||
Apache Geronimo v1.2 | GMOxDOC12 | Home for the Apache Geronimo v1.2 documentation. | |||
Apache Geronimo v1.1 | GMOxDOC11 | Home for the Apache Geronimo v1.1 and v1.1.1 documentation. | |||
Apache Geronimo v1.0 | GMOxDOC10 | Home for the Apache Geronimo v1.0 documentation. | |||
Apache Geronimo Development | GMOxDEV | All the information about how to develop Apache Geronimo goes here. In this space you will find details on Geronimo's architecture, how to build from the source, integration testing, problems reporting and tracking, etc. | |||
Apache Geronimo Project Management | GMOxPMGT | Here you will find ASF Board reports, details on the project development process such as contributor process and release management. You will also find here the project status, what is the level of integration in Geronimo from the other components, specs, other projects and subprojects. | |||
Apache Geronimo Knowledge Base | GMOxKB | Common Questions & Answers | |||
Apache Geronimo Samples | GMOxSAMPLES | This space is still under development, however it will soon have consolidated the sample applications for all the Geronimo releases. Currently each most Geronimo release space has it's own set of sample applications and configurations. | |||
Apache Geronimo SandBox | GMOxSBOX | Have you ever played in a sand box when a kid? Well, same story here. Feel free to test your documentation here, you can use it for pointing to your "on going" document and request for feedback and comments, then you can move your document to it's final place. You can also use this space to become familiar with the markup in Confluence. This space also contains some very-out-of-date documents from the previous wiki (these docs have been updated and integrated within the current documentation). | |||
Apache Geronimo TCK | GMOxTCK | PRIVATE. Some of the TCK certification communication is kept in this space. | |||
Apache Geronimo Website | GMOxSITE | Not in production. This space is a proof of concept for using Confluence as the authoring tool for live Web site. We are still using ant scripts, xdocs and Anakia. | Accessible only to Geronimo committers, see User groups below. This is the space we use to generate the project main web site http://geronimo.apache.org
| ||
Apache Geronimo v2.0 - ES | GMOxDOC20es | Home for the Apache Geronimo v2.0 documentation in Spanish. | |||
Apache Geronimo v2.0 - JA | GMOxDOC20ja | Home for the Apache Geronimo v2.0 documentation in Japanese | Geronimo_MoinMoin_wiki | GMOxMoinMoin | Previous to Confluence, the Geronimo project was using Moin Moin as official wiki. For historical reference this space holds the previous Moin Moin wiki migrated to Confluence format. |
Autoexport plugin
As mentioned earlier, in the Geronimo project we are using an autoexport plugin that runs in Confluence. This plugin generates an HTML version of the Confluence native content every time a user makes a change to any document. This plugin also allow us to massage the presentation of the content via templates so the Geronimo wiki has some resemblance to the Web site. Basically there are two templates in use, one for the documentation in general (geronimo_template.vs) and one for the Website (website_template.vs).
When you navigate the wiki (http://cwiki.apache.org/geronimo) you will actually be navigating through the HTML static version. Look at the URL in the following screenshot for instance.
...
The template used provides, among other things, the very cool Apache Geronimo top banner, navigational breadcrumbs where Home always point to http://cwiki.apache.org/geronimo, search capabilities, Confluence content editing links.
...
When making a reference to any document in the wiki you should point to this autoexported HTML content, avoid pointing directly to Confluence content. If the page you are browsing does not have the Geronimo banner on top then you are not looking at the HTML version.
Good: http://cwiki.apache.org/geronimo/geronimo-cwiki-documentation-architecture.html
Bad: http://cwiki.apache.org/confluence/display/geronimo/Tips+for+writing+and+formatting+documentation
Tip:
One way to get back to the HTML version of the page you just edited is to navigate to that particular page from http://cwiki.apache.org/geronimo .
...
For comments and/or concern, please join our mailing list and post your inquires there.
User groups
We are basically managing the following spaces
Confluence user groups | Description |
---|---|
geronimo-committers | All Geronimo committers, full administrative access to all Geronimo related spaces |
geronimo-contributors | Anybody wanting to contribute to the project's documentation. This is a restricted group and access to it depends on having a CLA filed with the ASF. |
geronimo-admins | This space is about to be replaced with the geronimo-committers group. |
geronimo-tck | Mostly Geronimo committers but there are committers from other Apache projects also. |
confluence-users | Just about everybody that signs up for a new account. Everybody is invited to contribute to the project. |
confluence-administrators | Confluence server administrators, these folks can solve some of the problems you may encounter from the daily use of Confluence. |
...