You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@deltacloud.apache.org by lu...@apache.org on 2010/10/26 01:29:47 UTC

svn commit: r1027310 - in /incubator/deltacloud/trunk/site: README content/contribute.haml content/contribute.mdown output/contribute.html

Author: lutter
Date: Mon Oct 25 23:29:47 2010
New Revision: 1027310

URL: http://svn.apache.org/viewvc?rev=1027310&view=rev
Log:
site: incorporate contents of README into content/contribute.mdown

Added:
    incubator/deltacloud/trunk/site/content/contribute.mdown
Removed:
    incubator/deltacloud/trunk/site/README
    incubator/deltacloud/trunk/site/content/contribute.haml
Modified:
    incubator/deltacloud/trunk/site/output/contribute.html

Added: incubator/deltacloud/trunk/site/content/contribute.mdown
URL: http://svn.apache.org/viewvc/incubator/deltacloud/trunk/site/content/contribute.mdown?rev=1027310&view=auto
==============================================================================
--- incubator/deltacloud/trunk/site/content/contribute.mdown (added)
+++ incubator/deltacloud/trunk/site/content/contribute.mdown Mon Oct 25 23:29:47 2010
@@ -0,0 +1,90 @@
+---
+title: Deltacloud - Contribute
+extension: html
+filter:
+  - markdown
+  - outline
+---
+Help make Deltacloud better
+===========================
+
+<toc class="toc" numbering="off" toc_style="ul" toc_range="h2-h3" />
+
+All development of Deltacloud takes place in the open. Communication is run
+through the mailing list and all source code changes are tracked publicly.
+
+* <strong>Mailing Lists</strong><br/>
+  For Deltacloud API: <de...@incubator.apache.org>.
+  To subscribe to it, send an email to <de...@incubator.apache.org>. You can also view [Archive][1] in case you are missing something.
+
+  [1]: http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/
+* <strong>IRC</strong><br/>
+  You can also join us on the Freenode IRC channel #deltacloud. Deltacloud
+  developers are generally available on the IRC channel
+* <strong>Bugs</strong><br/>
+  We track bugs in [Apache JIRA][2]. You can [view open bugs][view-bugs] or
+  [file a new one][new-bug] there.
+
+  [2]: https://issues.apache.org/jira/browse/DTACLOUD
+  [view-bugs]: https://issues.apache.org/jira/browse/DTACLOUD
+  [new-bug]: https://issues.apache.org/jira/secure/CreateIssue!default.jspa
+* <strong>Patches</strong><br/>
+  Patches are very welcome. Please send them to the [development
+  list][3]. Patches should be generated with [`git`&nbsp;`format-patch`][4]
+  and sent to the list with [`git`&nbsp;`send-email`][5].
+
+  [3]: http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/
+  [4]: http://kernel.org/pub/software/scm/git/docs/git-format-patch.html
+  [5]: http://kernel.org/pub/software/scm/git/docs/git-send-email.html
+
+Getting the sources
+-------------------
+
+Then Deltacloud Core gives you the API and drivers to various cloud providers.
+It also provides a client library and a commandline interface.
+
+The Deltacloud Core repository is hosted on Apache Incubator.
+Apache uses Subversion, but there is a git mirror available:
+
+    $ mkdir deltacloud
+    $ cd deltacloud
+    $ git clone git://git.apache.org/deltacloud.git core
+
+You can find the Subversion repository at: <https://svn.apache.org/repos/asf/incubator/deltacloud>.
+
+Required packages
+-----------------
+In order to make the Deltacloud components work, you'll need to
+have the following packages installed (on Fedora 12; the names may vary on
+your distro):
+
+    ruby
+    ruby-devel
+    gcc-c++
+    libxml2-devel
+    libxslt-devel
+
+**Note:** these packages are necessary for building all the required ruby gems
+that Deltacloud requires. If you want to install the gems using your system's
+package manager (yum, apt, ports, etc.) you won't need to install these
+packages manually.
+
+Installing the Deltacloud Core
+------------------------------
+
+First, you need to install the server that will give you the Deltacloud API:
+
+    $ cd path/to/deltacloud/core/server
+    $ rake package
+    $ sudo gem install pkg/deltacloud-core-<version>.gem
+
+Then install the client library:
+
+    $ cd path/to/deltacloud/core/client
+    $ rake package
+    $ sudo gem install pkg/deltacloud-client-<version>.gem
+
+Once you have the client installed, run the following command:
+
+    $ cd path/to/deltacloud/core/client
+    $ rake fixtures

Modified: incubator/deltacloud/trunk/site/output/contribute.html
URL: http://svn.apache.org/viewvc/incubator/deltacloud/trunk/site/output/contribute.html?rev=1027310&r1=1027309&r2=1027310&view=diff
==============================================================================
--- incubator/deltacloud/trunk/site/output/contribute.html (original)
+++ incubator/deltacloud/trunk/site/output/contribute.html Mon Oct 25 23:29:47 2010
@@ -43,7 +43,8 @@
     <div id='main'>
       <div class='container' id='content-deltacloud'>
         <h1>Help make Deltacloud better</h1>
-        <ul class="toc">
+        
+        <p><ul class="toc">
         <li>
         <a href="#h1">Getting the sources</a>
         </li>
@@ -53,32 +54,28 @@
         <li>
         <a href="#h3">Installing the Deltacloud Core</a>
         </li>
-        </ul>
-        <p>All development of Deltacloud takes place in the open. Communication is run through the mailing list and all source code changes are tracked publicly.</p>
+        </ul></p>
+        
+        <p>All development of Deltacloud takes place in the open. Communication is run
+        through the mailing list and all source code changes are tracked publicly.</p>
+        
         <ul>
-          <li>
-            <strong>Mailing Lists</strong>
-            <br />
-            <p>For Deltacloud API: <a href="&#109;&#x61;&#105;&#108;&#x74;&#x6f;&#x3a;&#x64;&#101;&#x6c;&#x74;&#97;&#x63;&#108;&#111;&#117;&#x64;&#45;&#x64;&#101;&#118;&#64;&#x69;&#110;&#99;&#117;&#98;&#97;&#116;&#111;&#114;&#46;&#x61;&#x70;&#97;&#99;&#104;&#101;&#46;&#111;&#x72;&#x67;">&#100;&#101;&#x6c;&#x74;&#97;&#99;&#x6c;&#111;&#117;&#100;&#45;&#x64;&#101;&#118;&#x40;&#105;&#x6e;&#x63;&#117;&#x62;&#x61;&#x74;&#111;&#114;&#46;&#97;&#112;&#97;&#x63;&#x68;&#x65;&#x2e;&#111;&#114;&#103;</a>.
-            To subscribe to it, send an email to <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;&#100;&#101;&#x6c;&#x74;&#97;&#99;&#x6c;&#111;&#x75;&#100;&#x2d;&#100;&#101;&#x76;&#45;&#115;&#x75;&#x62;&#115;&#99;&#x72;&#105;&#98;&#x65;&#64;&#105;&#x6e;&#x63;&#x75;&#x62;&#x61;&#x74;&#x6f;&#114;&#46;&#x61;&#112;&#x61;&#x63;&#104;&#101;&#x2e;&#111;&#114;&#103;">&#100;&#x65;&#108;&#116;&#x61;&#99;&#x6c;&#x6f;&#x75;&#100;&#x2d;&#x64;&#101;&#118;&#45;&#x73;&#117;&#x62;&#x73;&#99;&#114;&#105;&#x62;&#x65;&#64;&#x69;&#x6e;&#x63;&#x75;&#98;&#x61;&#x74;&#x6f;&#x72;&#x2e;&#97;&#112;&#97;&#x63;&#x68;&#x65;&#46;&#111;&#x72;&#x67;</a>.
-            You can also view <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/">Archive</a> in case you are missing something.</p>
-          </li>
-          <li>
-            <strong>IRC</strong>
-            <br />
-            <p>You can also join us on the Freenode IRC channel #deltacloud. Deltacloud developers are generally available on the IRC channel</p>
-          </li>
-          <li>
-            <strong>Bugs</strong>
-            <br />
-            <p>We track bugs in <a href="https://issues.apache.org/jira/browse/DTACLOUD">Apache JIRA</a>. You can <a href="https://issues.apache.org/jira/browse/DTACLOUD">view open bugs</a> or <a href="https://issues.apache.org/jira/secure/CreateIssue!default.jspa">file a new one</a> there.</p>
-          </li>
-          <li>
-            <strong>Patches</strong>
-            <br />
-            <p>Patches are very welcome. Please send them to the <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/">development list</a>. Patches should be generated with <a href="http://kernel.org/pub/software/scm/git/docs/git-format-patch.html"><code>git</code>&nbsp;<code>format-patch</code></a> and sent to the list with <a href="http://kernel.org/pub/software/scm/git/docs/git-send-email.html"><code>git</code>&nbsp;<code>send-email</code></a>.</p>
-          </li>
+        <li><p><strong>Mailing Lists</strong><br />
+        For Deltacloud API: <a href="&#109;&#x61;&#105;&#108;&#116;&#111;&#x3a;&#x64;&#x65;&#108;&#x74;&#x61;&#99;&#108;&#111;&#117;&#x64;&#45;&#x64;&#x65;&#118;&#64;&#x69;&#x6e;&#x63;&#x75;&#x62;&#97;&#116;&#x6f;&#114;&#46;&#97;&#112;&#97;&#x63;&#x68;&#x65;&#46;&#111;&#114;&#x67;">&#x64;&#101;&#108;&#x74;&#97;&#x63;&#x6c;&#x6f;&#117;&#100;&#45;&#100;&#x65;&#x76;&#x40;&#105;&#x6e;&#x63;&#x75;&#98;&#97;&#116;&#111;&#114;&#x2e;&#x61;&#112;&#x61;&#x63;&#104;&#x65;&#46;&#111;&#x72;&#x67;</a>.
+        To subscribe to it, send an email to <a href="&#109;&#97;&#x69;&#x6c;&#x74;&#x6f;&#x3a;&#x64;&#101;&#108;&#116;&#97;&#99;&#108;&#x6f;&#117;&#100;&#x2d;&#100;&#101;&#118;&#45;&#115;&#117;&#x62;&#115;&#x63;&#114;&#105;&#98;&#x65;&#64;&#105;&#110;&#99;&#x75;&#x62;&#x61;&#116;&#x6f;&#114;&#x2e;&#x61;&#112;&#x61;&#x63;&#104;&#x65;&#46;&#111;&#x72;&#x67;">&#100;&#101;&#x6c;&#116;&#97;&#99;&#108;&#x6f;&#117;&#x64;&#x2d;&#100;&#101;&#x76;&#45;&#x73;&#x75;&#98;&#x73;&#x63;&#x72;&#105;&#x62;&#101;&#x40;&#x69;&#x6e;&#99;&#x75;&#x62;&#x61;&#116;&#x6f;&#114;&#46;&#x61;&#112;&#97;&#99;&#104;&#x65;&#46;&#111;&#x72;&#x67;</a>. You can also view <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/">Archive</a> in case you are missing something.</p></li>
+        <li><p><strong>IRC</strong><br />
+        You can also join us on the Freenode IRC channel #deltacloud. Deltacloud
+        developers are generally available on the IRC channel</p></li>
+        <li><p><strong>Bugs</strong><br />
+        We track bugs in <a href="https://issues.apache.org/jira/browse/DTACLOUD">Apache JIRA</a>. You can <a href="https://issues.apache.org/jira/browse/DTACLOUD">view open bugs</a> or
+        <a href="https://issues.apache.org/jira/secure/CreateIssue!default.jspa">file a new one</a> there.</p></li>
+        <li><p><strong>Patches</strong><br />
+        Patches are very welcome. Please send them to the <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/">development
+        list</a>. Patches should be generated with <a href="http://kernel.org/pub/software/scm/git/docs/git-format-patch.html"><code>git</code>&nbsp;<code>format-patch</code></a>
+        and sent to the list with <a href="http://kernel.org/pub/software/scm/git/docs/git-send-email.html"><code>git</code>&nbsp;<code>send-email</code></a>.</p></li>
         </ul>
+        
+        
         <h2 id="h1">Getting the sources</h2>
         
         <p>Then Deltacloud Core gives you the API and drivers to various cloud providers.