svn commit: r635196 - in /geronimo/genesis/trunk: config/project-config/src/site/apt/index.apt config/project-config/src/site/site.xml pom.xml

[dj...@apache.org]

Author: djencks
Date: Sun Mar  9 00:45:22 2008
New Revision: 635196

URL: http://svn.apache.org/viewvc?rev=635196&view=rev
Log:
try to add some docs on project-config.  site does not generate correctly

Added:
    geronimo/genesis/trunk/config/project-config/src/site/apt/index.apt
Modified:
    geronimo/genesis/trunk/config/project-config/src/site/site.xml
    geronimo/genesis/trunk/pom.xml

Added: geronimo/genesis/trunk/config/project-config/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/geronimo/genesis/trunk/config/project-config/src/site/apt/index.apt?rev=635196&view=auto
==============================================================================
--- geronimo/genesis/trunk/config/project-config/src/site/apt/index.apt (added)
+++ geronimo/genesis/trunk/config/project-config/src/site/apt/index.apt Sun Mar  9 00:45:22 2008
@@ -0,0 +1,61 @@
+------
+ Genesis project-config for Geronimo projects
+ ------
+ ------
+ $Rev: $ $Date: $
+
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements.  See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership.  The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License.  You may obtain a copy of the License at
+~~
+~~  http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied.  See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+~~
+
+Tips for setting up Geronimo projects to use the genesis features:
+
+Legal files:
+
+* Each "complete project" under trunk/branches/tags MUST have a LICENSE and NOTICE file checked into svn that applies to the
+  entire project.
+
+* All other subprojects should not have LICENSE or NOTICE files. If the standard files are not sufficient due to inclusion of
+  code under non-asl licenses or other reasons, the ADDITIONAL material to be appended to the standard LICENSE and NOTICE files
+  should be put in src/main/appended-resources/LICENSE and src/main/appended-resources/NOTICE
+
+* If for some reason correct legal files cannot be constructed in this way, the tools-maven-plugin:install-legal-files can be
+  used to install explicitly constructed files.
+
+* A DEPENDENCIES file will be constructed listing the transitive dependencies of the project, organization, and license.
+
+Site generation:
+
+* Sites go in http://geronimo.apache.org/maven/$artifactId/$version.
+  This is divided up into ${staging.siteURL}/${siteId}/${version}
+
+* In the root project for the site, set the siteId property to the artifactId of the project, such as "server" or "roller"
+
+* In your settings.xml set staging.siteURL in the release profile and in another profile such as default.  You can set
+  these to different values for different purposes.  The release location should be
+  scp://people.apache.org/x1/home/<your apache id>/public_html/staging-site
+
+* When building the site be sure to include the profile with the desired site location.
+
+Release:
+
+* Be sure the scm section of the root pom is correct.
+
+* See the release process docs on the wiki for information about setting up your settings.xml.
+
+* If your project follows the normal trunk/branches/tags layout no further configuration should be necessary.
\ No newline at end of file

Modified: geronimo/genesis/trunk/config/project-config/src/site/site.xml
URL: http://svn.apache.org/viewvc/geronimo/genesis/trunk/config/project-config/src/site/site.xml?rev=635196&r1=635195&r2=635196&view=diff
==============================================================================
--- geronimo/genesis/trunk/config/project-config/src/site/site.xml (original)
+++ geronimo/genesis/trunk/config/project-config/src/site/site.xml Sun Mar  9 00:45:22 2008
@@ -24,7 +24,7 @@
     <skin>
         <groupId>org.apache.geronimo.genesis.config</groupId>
         <artifactId>geronimo-skin</artifactId>
-        <version>1.2-SNAPSHOT</version>
+        <version>1.4-SNAPSHOT</version>
     </skin>
     
     <publishDate format="dd MMM yyyy"/>

Modified: geronimo/genesis/trunk/pom.xml
URL: http://svn.apache.org/viewvc/geronimo/genesis/trunk/pom.xml?rev=635196&r1=635195&r2=635196&view=diff
==============================================================================
--- geronimo/genesis/trunk/pom.xml (original)
+++ geronimo/genesis/trunk/pom.xml Sun Mar  9 00:45:22 2008
@@ -145,7 +145,6 @@
     <distributionManagement>
         <site>
             <id>geronimo-website</id>
-            <!--<url>${staging.siteURL}/genesis/${version}</url>-->
             <url>${staging.siteURL}/${siteId}/${version}</url>
         </site>
     </distributionManagement>