deltaspike-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1626073 - in /deltaspike/site/trunk/content: community.mdtext documentation.mdtext
Date Thu, 18 Sep 2014 20:17:56 GMT
Author: rafabene
Date: Thu Sep 18 20:17:55 2014
New Revision: 1626073

DELTASPIKE-716 - Added DS Documentaiton info page


Modified: deltaspike/site/trunk/content/community.mdtext
--- deltaspike/site/trunk/content/community.mdtext (original)
+++ deltaspike/site/trunk/content/community.mdtext Thu Sep 18 20:17:55 2014
@@ -38,6 +38,9 @@ You are very welcome to follow our twitt
 Everybody is welcome to get involved with our community. You can find general information
at [](
and [](
 The following sections provides some details about the different levels of getting involved.
+If you want to contribute with [DeltaSpike Documentation](/documentation/), please read the
+about the Documentation](documentation.html) that adresses how to contribute, render and
publish it.
 ## Contributors
 Before you get a committer you have to contribute to our effort. E.g. you can help users,
participate in discussions on the dev list, submit patches,... . Therefore, it's essential
to file a/n [(I)CLA]( or [CLA](
and send it to secretary at apache dot org (or fax it) as early as possible.

Added: deltaspike/site/trunk/content/documentation.mdtext
--- deltaspike/site/trunk/content/documentation.mdtext (added)
+++ deltaspike/site/trunk/content/documentation.mdtext Thu Sep 18 20:17:55 2014
@@ -0,0 +1,60 @@
+Title: Documentation
+Notice:    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
+           .
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+# Sources
+DeltaSpike documentation is available with the [sources](documentation/source.html).
+# Format
+The format used for DeltaSpike documentation is [ASCIIDOC](
because it's easily exportable to PDF, HTML, and it's also easy to contribute. It can be used
to export also to epub and also be used to write books
+# Rendering documentation as HTML
+_Requirenment: Have [Maven]( installed._
+If you cloned the source repository and want to render the documentation as HTML, you just
need to run the following command:
+    $ cd REPO_ROOT/documentation
+    $ mvn site
+The generate documentation will be available at `REPO_ROOT/documentation/target/site`
+# Publish procedure
+To publish the documentation at [DeltaSpike Site](
you have do the following steps:
+Put the following information in your ~/.m2/settings.xml file
+    <server>
+      <id>deltaspike-site</id>
+      <username><YOUR_USERNAME></username>
+      <password><YOUR_PASSWORD></password>
+    </server>
+Then run:
+    mvn site-deploy
+After log in to <> and click on the `Submit`
\ No newline at end of file

View raw message