cayenne-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ntimof...@apache.org
Subject cayenne-website git commit: Add legacy documentation Optimize layout Update cms guide
Date Tue, 16 Jan 2018 13:56:04 GMT
Repository: cayenne-website
Updated Branches:
  refs/heads/master 4db8c2d84 -> 11d328b5a


Add legacy documentation
Optimize layout
Update cms guide


Project: http://git-wip-us.apache.org/repos/asf/cayenne-website/repo
Commit: http://git-wip-us.apache.org/repos/asf/cayenne-website/commit/11d328b5
Tree: http://git-wip-us.apache.org/repos/asf/cayenne-website/tree/11d328b5
Diff: http://git-wip-us.apache.org/repos/asf/cayenne-website/diff/11d328b5

Branch: refs/heads/master
Commit: 11d328b5a210875b43890d11dda8525161a84f54
Parents: 4db8c2d
Author: Nikita Timofeev <stariy95@gmail.com>
Authored: Tue Jan 16 16:55:58 2018 +0300
Committer: Nikita Timofeev <stariy95@gmail.com>
Committed: Tue Jan 16 16:55:58 2018 +0300

----------------------------------------------------------------------
 src/main/site/content/collaboration.md          |  17 ---
 src/main/site/content/collaboration/_index.md   |  19 +++
 .../site/content/collaboration/contributors.md  |  12 ++
 .../content/collaboration/how-can-i-help.md     |  27 +++++
 .../site/content/collaboration/mailing-lists.md |  55 +++++++++
 src/main/site/content/contributors.md           |  12 --
 src/main/site/content/dev/cms-guide.md          |   2 +
 src/main/site/content/how-can-i-help.md         |  27 -----
 .../site/content/legacy/legacy-ant-build.md     |  16 +++
 .../content/legacy/legacy-ant-unit-tests.md     | 100 +++++++++++++++
 src/main/site/content/legacy/legacy-eclipse.md  |  47 +++++++
 .../content/legacy/legacy-release-guide-2.0.md  | 121 +++++++++++++++++++
 src/main/site/content/mailing-lists.md          |  55 ---------
 src/main/site/layouts/collaboration/list.html   |  16 +++
 src/main/site/static/.htaccess                  |   2 +-
 15 files changed, 416 insertions(+), 112 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/collaboration.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/collaboration.md b/src/main/site/content/collaboration.md
deleted file mode 100644
index 7365bb4..0000000
--- a/src/main/site/content/collaboration.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: Collaboration
-menu:  
-    footer:
-        weight: 30
-        identifier: collaboration
----
-
-Cayenne is the result of collaboration of many skilled people. This is a
-set of links to access Cayenne collaboration resources and information.
-
-* [Bug/Feature Tracker](http://issues.apache.org/jira/browse/CAY)
-* [Support](/support/)
-* [Code Repository](/dev/code-repository.html)
-* [Developer Guide](/dev/)
-* [How Can I Help?](/how-can-i-help.html)
-* [Contributors](/contributors.html)
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/collaboration/_index.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/collaboration/_index.md b/src/main/site/content/collaboration/_index.md
new file mode 100644
index 0000000..f32d110
--- /dev/null
+++ b/src/main/site/content/collaboration/_index.md
@@ -0,0 +1,19 @@
+---
+title: Collaboration
+menu:  
+    footer:
+        weight: 30
+        identifier: collaboration
+url: /collaboration/
+layout: single
+---
+
+Cayenne is the result of collaboration of many skilled people. This is a
+set of links to access Cayenne collaboration resources and information.
+
+* [Bug/Feature Tracker](http://issues.apache.org/jira/browse/CAY)
+* [Support](/about/support/)
+* [Code Repository](/dev/code-repository.html)
+* [Developer Guide](/dev/)
+* [How Can I Help?](/how-can-i-help.html)
+* [Contributors](/contributors.html)
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/collaboration/contributors.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/collaboration/contributors.md b/src/main/site/content/collaboration/contributors.md
new file mode 100644
index 0000000..198f1c3
--- /dev/null
+++ b/src/main/site/content/collaboration/contributors.md
@@ -0,0 +1,12 @@
+---
+# Content of this page is mostly generated, see layouts/_default/contributors.html and data/contributors.yaml.
+# Any markdown in this file will be rendered at the beginning of the final page.
+title: Contributors
+menu:  
+    footer:
+        weight: 60
+        identifier: contributors
+        parent: collaboration
+url: /contributors.html
+layout: contributors
+---

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/collaboration/how-can-i-help.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/collaboration/how-can-i-help.md b/src/main/site/content/collaboration/how-can-i-help.md
new file mode 100644
index 0000000..e5cd571
--- /dev/null
+++ b/src/main/site/content/collaboration/how-can-i-help.md
@@ -0,0 +1,27 @@
+---
+title: How can I help?
+menu:  
+    footer:
+        weight: 50
+        identifier: how-can-i-help
+        parent: collaboration
+url: /how-can-i-help.html
+---
+Every volunteer project gets its strength from its participants. We invite
+everybody to participate in Cayenne. If you are willing to help,
+this can be done in many different ways, by:
+
+* contributing code
+* contributing documentation
+* helping others on the mailing list
+* using Cayenne and reporting issues or missing features
+* suggesting your own ideas on the mailing list and contributing code
+implementing them
+
+If you want to contribute to Cayenne, first you should subscribe
+to the [developer mailing list](mailing-lists.html) to see what issues are discussed and
to
+communicate with the project team.
+
+Next, clone the git source and make your changes. You can submit a patch in standard diff
format and attach it to our Jira task tracker, or more easily you can use [github](https://github.com/apache/cayenne)
to fork the project and submit a [Pull Request](https://help.github.com/articles/using-pull-requests/).
+
+Don't forget to also raise your issue on the Cayenne mailing list or make a ticket in Jira,
since we may not notice your pull request.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/collaboration/mailing-lists.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/collaboration/mailing-lists.md b/src/main/site/content/collaboration/mailing-lists.md
new file mode 100644
index 0000000..d623798
--- /dev/null
+++ b/src/main/site/content/collaboration/mailing-lists.md
@@ -0,0 +1,55 @@
+---
+title: Mailing Lists
+menu:  
+    footer:
+        weight: 20
+        identifier: mail-list
+        parent: collaboration
+url: /mailing-lists.html
+---
+## User Mailing List
+
+This is a general discussion and support list for Cayenne users. It is the
+primary source of free Cayenne support. It is also a place for general
+discussion of Cayenne-related topics.
+
+To subscribe send empty email to user-subscribe@cayenne.apache.org  
+To unsubscribe send empty email to user-unsubscribe@cayenne.apache.org  
+To post a message use the following address: user@cayenne.apache.org
+
+* [Apache Message Archive](https://lists.apache.org/list.html?user@cayenne.apache.org)
+* [Apache Message Archive - Old Style](http://mail-archives.apache.org/mod_mbox/cayenne-user/)
+* [ObjectStyle.org Archive](http://objectstyle.org/cayenne/lists/cayenne-user/) (legacy,
does not store new messages, but has very old messages not available elsewhere)
+
+{{% gap %}}
+
+## Developer Mailing List
+
+'dev' is a mailing list where Cayenne design issues are discussed. This
+includes current and future features, release schedules, and simply
+developer discussion of various Cayenne-related topics. It is a good idea
+for all Cayenne committers to subscribe to this list. Others are welcomed to
+subscribe and participate if they are interested in the topics discussed
+here.
+
+To subscribe send empty email to dev-subscribe@cayenne.apache.org  
+To unsubscribe send empty email to dev-unsubscribe@cayenne.apache.org  
+To post a message use the following address: dev@cayenne.apache.org
+
+* [Apache Message Archive](https://lists.apache.org/list.html?dev@cayenne.apache.org)
+* [Apache Message Archive - Old Style](http://mail-archives.apache.org/mod_mbox/cayenne-dev/)
+* [ObjectStyle.org Archive](http://objectstyle.org/cayenne/lists/cayenne-devel/) (legacy,
does not store new messages, but has very old messages not available elsewhere)
+
+{{% gap 2 %}}
+
+## Commits Mailing List
+
+'commits' is a mailing list that receives all of the Cayenne SVN commit
+messages. You can subscribe to this list to keep track of changes to the
+Cayenne SVN repository.
+
+To subscribe send empty email to commits-subscribe@cayenne.apache.org  
+To unsubscribe send empty email to commits-unsubscribe@cayenne.apache.org
+
+* [Apache Message Archive](https://lists.apache.org/list.html?commits@cayenne.apache.org)
+* [Apache Message Archive - Old Style](http://mail-archives.apache.org/mod_mbox/cayenne-commits/)

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/contributors.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/contributors.md b/src/main/site/content/contributors.md
deleted file mode 100644
index 174a65b..0000000
--- a/src/main/site/content/contributors.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-# Content of this page is mostly generated, see layouts/_default/contributors.html and data/contributors.yaml.
-# Any markdown in this file will be rendered at the beginning of the final page.
-title: Contributors
-menu:  
-    footer:
-        weight: 60
-        identifier: contributors
-        parent: collaboration
-url: contributors.html
-layout: contributors
----

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/dev/cms-guide.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/dev/cms-guide.md b/src/main/site/content/dev/cms-guide.md
index 65a93ff..616f4a1 100644
--- a/src/main/site/content/dev/cms-guide.md
+++ b/src/main/site/content/dev/cms-guide.md
@@ -66,9 +66,11 @@ You can use following template:
 To update site content with information about new Cayenne version you need to perform these
steps:
 
 * Update data in `src/main/site/data/cayenne.yaml` file.
+This automatically update [download](/download/) page and `/doap/caynne.rdf` file.
 * Write news (see information above).
 * Update documentation, this can be done with `build-docs.sh` script. 
   You can run it like this: `./build-docs.sh 4.1.M2` 
+* Publish your changes (see [publish](#Publish) section)
 
 {{% gap %}}
 

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/how-can-i-help.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/how-can-i-help.md b/src/main/site/content/how-can-i-help.md
deleted file mode 100644
index 0c37831..0000000
--- a/src/main/site/content/how-can-i-help.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: How can I help?
-menu:  
-    footer:
-        weight: 50
-        identifier: how-can-i-help
-        parent: collaboration
-url: how-can-i-help.html
----
-Every volunteer project gets its strength from its participants. We invite
-everybody to participate in Cayenne. If you are willing to help,
-this can be done in many different ways, by:
-
-* contributing code
-* contributing documentation
-* helping others on the mailing list
-* using Cayenne and reporting issues or missing features
-* suggesting your own ideas on the mailing list and contributing code
-implementing them
-
-If you want to contribute to Cayenne, first you should subscribe
-to the [developer mailing list](mailing-lists.html) to see what issues are discussed and
to
-communicate with the project team.
-
-Next, clone the git source and make your changes. You can submit a patch in standard diff
format and attach it to our Jira task tracker, or more easily you can use [github](https://github.com/apache/cayenne)
to fork the project and submit a [Pull Request](https://help.github.com/articles/using-pull-requests/).
-
-Don't forget to also raise your issue on the Cayenne mailing list or make a ticket in Jira,
since we may not notice your pull request.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/legacy/legacy-ant-build.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/legacy/legacy-ant-build.md b/src/main/site/content/legacy/legacy-ant-build.md
new file mode 100644
index 0000000..fde7a5d
--- /dev/null
+++ b/src/main/site/content/legacy/legacy-ant-build.md
@@ -0,0 +1,16 @@
+---
+title: Legacy Ant Build
+url: /legacy-ant-build.html
+---
+This procedure applies to versions 1.2 and 2.0 that are built with Ant. To
+build Cayenne with Ant, check out the appropriate source code branch from
+Subversion and perform the following command to see available targets:
+
+
+    # cd cayenne/cayenne-ant
+    # ant help
+
+
+Required ant version - 1.6.* or newer; required JDK version - 1.5.* or
+newer. Note that compiled binaries are JDK 1.4 compatible, still JDK 1.5 is
+needed to build a few extensions.

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/legacy/legacy-ant-unit-tests.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/legacy/legacy-ant-unit-tests.md b/src/main/site/content/legacy/legacy-ant-unit-tests.md
new file mode 100644
index 0000000..0259830
--- /dev/null
+++ b/src/main/site/content/legacy/legacy-ant-unit-tests.md
@@ -0,0 +1,100 @@
+---
+title: Legacy Ant Unit Tests
+url: /legacy-ant-unit-tests.html
+markup: mmark
+---
+Cayenne provides a comprehensive suite of unit tests. To execute unit tests
+you must first [get Cayenne from SVN](/dev/code-repository.html)
+, install JDK 1.5 and obtain the latest Ant.
+
+<a name="LegacyAntUnitTests-SummaryofBuildProperties"></a>
+## Summary of Build Properties
+
+These properties can be passed to ant build via *-DpropName=value*.
+
+{.table .table-bordered}
+Property | Description
+---------|------------
+*cayenne.test.connection* | Named connection source (see below)
+*test.filter* | Running a subset of tests (see below)
+*cayenne.test.schema.skip* | If "true", won't attempt to recreate the test database, i.e.
the database must already be present.
+
+<a name="LegacyAntUnitTests-RunningAgainstEmbeddedHSQLDB"></a>
+## Running Against Embedded HSQLDB
+
+No extra setup is required. Just run Ant:
+
+
+    # cd cayenne/cayenne-ant
+    # ant test
+
+
+Optionally you may run JDK 1.4 tests only (e.g. if you don't have JDK 1.5
+on your machine):
+
+
+    # cd cayenne/cayenne-ant
+    # ant test-1_4
+
+
+
+This will use an embedded HSQLDB. Running tests against your own database
+requires a few extra steps described below.
+
+<a name="LegacyAntUnitTests-RunningAgainstaSpecificDatabase"></a>
+## Running Against a Specific Database
+
+<a name="LegacyAntUnitTests-Step1:ConfigureOneorMoreDataSources"></a>
+#### Step 1: Configure One or More Data Sources
+
+Create a directory *$HOME/.cayenne/* and place a file called
+*connection.properties* in this directory. File contents should be
+similar to this example:
+
+
+    example1.cayenne.adapter = org.apache.cayenne.dba.mysql.MySQLAdapter
+    example1.jdbc.username = someuser
+    example1.jdbc.password = somepasswd
+    example1.jdbc.url = jdbc:someurl1
+    example1.jdbc.driver = com.xyz.MyDriverClass
+    
+    example2.cayenne.adapter = org.apache.cayenne.dba.oracle.OracleAdapter
+    example2.jdbc.username = someuser
+    example2.jdbc.password = somepasswd
+    example2.jdbc.url = jdbc:someurl2
+    example2.jdbc.driver = com.xyz.MyDriverClass
+
+
+Each key starts with an identifier for a datasource. In the file above,
+"example1" and "example2" are such identifiers. They can be arbitrary
+strings without "." (dot) symbols.
+
+
+<a name="LegacyAntUnitTests-Step2.RunTestsAgainstConfiguredDataSource"></a>
+#### Step 2. Run Tests Against Configured Data Source
+
+
+    # cd cayenne/cayenne-ant
+    # ant test -Dcayenne.test.connection=example1
+
+
+Substitute "example1" with a name of your data source configured in the
+previous step. In case of total success, one of the last messages Ant
+prints on console is BUILD SUCCESSFUL. If build fails, failure report is
+generated in HTML format under
+*cayenne/cayenne-ant/build/tests-report-example1/index.html* and can be
+viewed using a web browser (again, substitute "example1" in this path with
+the name of data source used).
+
+<a name="LegacyAntUnitTests-FilteringTests"></a>
+## Filtering Tests
+
+To run only a subset of test cases, Ant-style pattern matching can be used.
+A property called *test.filter* defines a set of class files to be run.
+For instance to run only tests from the "tools" package, the following
+startup parameters can be used:
+
+
+    # cd cayenne/cayenne-ant
+    # ant test -Dcayenne.test.connection=example1 -Dtest.filter="**/tools/*Tst.class"
+

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/legacy/legacy-eclipse.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/legacy/legacy-eclipse.md b/src/main/site/content/legacy/legacy-eclipse.md
new file mode 100644
index 0000000..b32a4c8
--- /dev/null
+++ b/src/main/site/content/legacy/legacy-eclipse.md
@@ -0,0 +1,47 @@
+---
+title: Legacy Eclipse
+url: /legacy-eclipse.html
+markup: mmark
+---
+<a name="LegacyEclipse-UsingEclipsewithAntCayenne"></a>
+## Using Eclipse with Ant Cayenne 
+_(versions 1.2 and 2.0)_
+
+<a name="LegacyEclipse-ConfiguringEclipseWorkspaceforCayenne"></a>
+### Configuring Eclipse Workspace for Cayenne
+
+* Download and install [Eclipse](http://wwww.eclipse.org)
+. Eclipse 3.1.1 or newer is recommended, as there are some per-project
+settings in repository that are not understood by older Eclipse.
+* Install both JDK1.4 and 1.5. Some Cayenne projects below require JVM
+1.5.x, and others - JVM 1.4.x. It is possible to develop all or parts of
+Cayenne with just 1.5 or just 1.4, but make sure you understand what you
+are doing.
+* Set JVM 1.4 as default workspace JVM.
+* Define *"JRE_LIB_15"* Eclipse variable (Preferences -> Java -> Build
+Path -> Classpath Variable) to point to the JRE 1.5 class library (e.g.
+*"JRE15_HOME/jre/lib/rt.jar"* on Windows and Linux or
+*"/System/Library/Frameworks/JavaVM.framework/Versions/1.5/Classes/classes.jar"*
+on Mac OS X). Cayenne projects that are compatible with 1.5 rely on this
+variable.
+
+
+<a name="LegacyEclipse-CheckingOutEclipseProjects"></a>
+### Checking Out Eclipse Projects
+
+Under [cayenne folder](https://svn.apache.org/repos/asf/cayenne/main/branches/STABLE-2.0/cayenne/)
+ in Subversion you'll find 4 Eclipse projects that need to be checked out
+to the same workspace. You may skip projects marked as optional if you are
+not planning to use/change them.
+
+
+{.table .table-bordered}
+Project Folder | JVM | Special Setup | Notes
+---------------|-----|---------------|------
+*/cayenne-java* | 1.4.x | n/a | Eclipse project containing main Cayenne source and library
folders. Source and binary compatibility must be set to JDK 1.4.
+*/cayenne-java-1.5* | 1.5.x | *JRE_LIB_15* variable | Eclipse projectcontaining Cayenne JDK
1.5 specific code. Requires "cayenne-java" project to be present in workspace. Source and
binary compatibility must be set to JDK 1.5.
+*/cayenne-other* | 1.5.x | *JRE_LIB_15* variable | Optional Eclipse project that contains
Cayenne documentation, contrib folders and such.
+*/cayenne-ant* | n/a | n/a | Eclipse project with Ant build files to build the entire Cayenne
workspace. Needed if you are planning to build Cayenne with Ant outside of Eclipse (i.e. to
create JAR files or run a test suite).
+
+There are also various tutorials in "cayenne" folder that are not needed to
+build the framework or the tools.

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/legacy/legacy-release-guide-2.0.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/legacy/legacy-release-guide-2.0.md b/src/main/site/content/legacy/legacy-release-guide-2.0.md
new file mode 100644
index 0000000..96beb14
--- /dev/null
+++ b/src/main/site/content/legacy/legacy-release-guide-2.0.md
@@ -0,0 +1,121 @@
+---
+title: Legacy Release Guide 2.0
+url: /release-guide-2.0.html
+---
+Note that this page is of use for committers only. It describes the general
+procedure of building a Cayenne release.
+
+*THIS ONLY REFERS TO 2.0.x RELEASE BRANCH*
+
+<a name="ReleaseGuide2.0-Prerequisites"></a>
+## Prerequisites
+
+Refer to the Prerequisites section of the [main release guide](/dev/release-guide.html)
+
+<a name="ReleaseGuide2.0-PreparingSources"></a>
+## Preparing Sources
+
+* Export and commit the latest documentation per Documentation Guidelines
+.
+
+* Create a report in Jira listing all issues that are FIXED but not CLOSED,
+paste its contents to RELEASE-NOTES.txt. Bulk-close all involved issues.
+_Note that issues that affect multiple releases are usually closed
+immediately when they are fixed, and the note is placed in
+RELEASE-NOTES.txt immediately when this happens._
+
+* Edit UPGRADE-NOTES.txt if there is anything to add there.
+
+* Check Sources Compliance with ARAT. [ARAT](http://code.google.com/p/arat/)
+ (A Release Audit Tool) is a Java tool written by Robert Burrell Donkin for
+checking the release files for ASF licensing compliance. To run ARAT, [check it out of SVN](http://arat.googlecode.com/svn/tags/RAT_0_4/)
+ _(we are using version 0.4)_, build with Ant, and run against unpacked
+distro (or the release tag), read the report and fix any issues.
+
+ 
+## Building Release Artifacts
+    
+* Tag `cayenne` directory under the repository trunk (assuming
+    `release_version` is a version tag identifying the release, such as
+    `"1.2B3"`):
+   
+   
+   
+     svn copy https://svn.apache.org/repos/asf/cayenne/main/trunk/cayenne \
+     https://svn.apache.org/repos/asf/cayenne/main/tags/release_version/cayenne -m "tagging
B3 release"
+     
+    
+* Switch an existing working copy on a build machine to the release tag:
+    If you don't have a local copy, do "checkout" instead of "switch". _Do not
+    forget to switch the local copy back to the appropriate branch in case you
+    are using it to make the code changes._
+
+* Note that all Ant commands now must contain *"project.version"*
+    property corresponding to the release version. The property is passed on
+    the command line as *"-Dproject.version=2.0.x"*. See examples below.
+
+* Run a test to make sure the checkout is ok:    
+    Test with all supported databases listed [here](/database-support.html)
+, or at least as many as possible.  See [Legacy Ant Unit Tests](/legacy-ant-unit-tests.html)
+ for more details on how to test each of the various database servers with
+legacy versions of Cayenne.
+    
+* Build a release for the target platform:
+    
+* Build Release Maven Bundles for ibiblio upload:
+    
+* Signing release
+    For more info visit [this page](http://www.apache.org/dev/release-signing.html)
+. Release manager key must be in the project KEYS file. Signing is a manual
+procedure not included in the Ant or Maven script. Here is how it might
+work ("-u" option can be omitted if you have only one GPG key):
+    
+<a name="ReleaseGuide2.0-Voting"></a>
+## Voting
+
+Refer to the Voting section of the [main release guide](/dev/release-guide.html)
+
+<a name="ReleaseGuide2.0-PublishingtheRelease"></a>
+## Publishing the Release
+
+Copy KEYS file if updated to `"/www/www.apache.org/dist/cayenne/"`
+_(TODO: automate publishing the keys - maybe create a "dist" site project?)_
+    
+    
+    chmod 664 /www/www.apache.org/dist/cayenne/*
+
+<a name="ReleaseGuide2.0-PublishingMavenArtifacts"></a>
+### Publishing Maven Artifacts
+_(TODO: automate rsync with Ant)_
+
+Assuming release version is 2.0.2, on a *local machine* do 
+
+
+    ant clean mvn-install -Dproject.version=2.0.2
+    
+    rsync -azv ~/.m2/repository/org/apache/cayenne/cayenne-nodeps/2.0.2 \
+    people.apache.org:/www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/cayenne/cayenne-nodeps/
+    
+    rsync -azv ~/.m2/repository/org/apache/cayenne/cayenne/2.0.2 \
+    people.apache.org:/www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/cayenne/cayenne/
+    
+    rsync -azv ~/.m2/repository/org/apache/cayenne/cayenne-client-nodeps/2.0.2 \
+    people.apache.org:/www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/cayenne/cayenne-client-nodeps/
+    
+    rsync -azv ~/.m2/repository/org/apache/cayenne/cayenne-modeler/2.0.2 \
+    people.apache.org:/www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/cayenne/cayenne-modeler/
+
+<a name="ReleaseGuide2.0-Aftertherelease"></a>
+## After the release
+
+* Update the [DOAP file](http://svn.apache.org/repos/asf/cayenne/site/trunk/tlp-site/src/doap/cayenne.rdf)
+ (held in the Cayenne svn) which will update
+https://projects.apache.org/project.html?cayenne automatically
+* Update Freshmeat with new release number
+(http://freshmeat.net/projects/cayenne/)
+* If the release is significant, consider press releases to relevant news
+sources
+* Review the main website pages (front page and why-cayenne especially) to
+add any new features
+* Add a news item to the Cayenne web site
+* Send an email to the Cayenne user and developer lists

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/content/mailing-lists.md
----------------------------------------------------------------------
diff --git a/src/main/site/content/mailing-lists.md b/src/main/site/content/mailing-lists.md
deleted file mode 100644
index d4ddb34..0000000
--- a/src/main/site/content/mailing-lists.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-title: Mailing Lists
-menu:  
-    footer:
-        weight: 20
-        identifier: mail-list
-        parent: collaboration
-url: mailing-lists.html
----
-## User Mailing List
-
-This is a general discussion and support list for Cayenne users. It is the
-primary source of free Cayenne support. It is also a place for general
-discussion of Cayenne-related topics.
-
-To subscribe send empty email to user-subscribe@cayenne.apache.org  
-To unsubscribe send empty email to user-unsubscribe@cayenne.apache.org  
-To post a message use the following address: user@cayenne.apache.org
-
-* [Apache Message Archive](https://lists.apache.org/list.html?user@cayenne.apache.org)
-* [Apache Message Archive - Old Style](http://mail-archives.apache.org/mod_mbox/cayenne-user/)
-* [ObjectStyle.org Archive](http://objectstyle.org/cayenne/lists/cayenne-user/) (legacy,
does not store new messages, but has very old messages not available elsewhere)
-
-{{% gap %}}
-
-## Developer Mailing List
-
-'dev' is a mailing list where Cayenne design issues are discussed. This
-includes current and future features, release schedules, and simply
-developer discussion of various Cayenne-related topics. It is a good idea
-for all Cayenne committers to subscribe to this list. Others are welcomed to
-subscribe and participate if they are interested in the topics discussed
-here.
-
-To subscribe send empty email to dev-subscribe@cayenne.apache.org  
-To unsubscribe send empty email to dev-unsubscribe@cayenne.apache.org  
-To post a message use the following address: dev@cayenne.apache.org
-
-* [Apache Message Archive](https://lists.apache.org/list.html?dev@cayenne.apache.org)
-* [Apache Message Archive - Old Style](http://mail-archives.apache.org/mod_mbox/cayenne-dev/)
-* [ObjectStyle.org Archive](http://objectstyle.org/cayenne/lists/cayenne-devel/) (legacy,
does not store new messages, but has very old messages not available elsewhere)
-
-{{% gap 2 %}}
-
-## Commits Mailing List
-
-'commits' is a mailing list that receives all of the Cayenne SVN commit
-messages. You can subscribe to this list to keep track of changes to the
-Cayenne SVN repository.
-
-To subscribe send empty email to commits-subscribe@cayenne.apache.org  
-To unsubscribe send empty email to commits-unsubscribe@cayenne.apache.org
-
-* [Apache Message Archive](https://lists.apache.org/list.html?commits@cayenne.apache.org)
-* [Apache Message Archive - Old Style](http://mail-archives.apache.org/mod_mbox/cayenne-commits/)

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/layouts/collaboration/list.html
----------------------------------------------------------------------
diff --git a/src/main/site/layouts/collaboration/list.html b/src/main/site/layouts/collaboration/list.html
new file mode 100644
index 0000000..6bb9e72
--- /dev/null
+++ b/src/main/site/layouts/collaboration/list.html
@@ -0,0 +1,16 @@
+{{ partial "head.html" . }}
+{{ partial "header.html" . }}
+
+{{ $baseurl := .Site.BaseURL }}
+
+    <main class="container  py-5">
+        <section>
+            <article>
+                <h1 class="text-center">{{ .Title }}</h1>
+                {{ .Content }}
+            </article>
+        </section>
+    </main> 
+
+{{ partial "footer.html" . }}
+{{ partial "tail.html" . }}

http://git-wip-us.apache.org/repos/asf/cayenne-website/blob/11d328b5/src/main/site/static/.htaccess
----------------------------------------------------------------------
diff --git a/src/main/site/static/.htaccess b/src/main/site/static/.htaccess
index 508f6c8..85a365c 100644
--- a/src/main/site/static/.htaccess
+++ b/src/main/site/static/.htaccess
@@ -37,7 +37,7 @@ Redirect permanent /about.html /
 Redirect permanent /collaboration.html /
 Redirect permanent /thanks.html /
 Redirect permanent /release-guide-2.0.html /dev/release-guide.html
-RedirectMatch permanent ^/legacy(.*).html$ /
+Redirect permanent /legacy-ant-documentation-export.html /
 
 # Custom 404 error page
 ErrorDocument 404 /404.html


Mime
View raw message