You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by bm...@apache.org on 2015/04/23 21:38:41 UTC
svn commit: r1675709 [1/3] - in /mesos/site: publish/ publish/documentation/
publish/documentation/latest/ publish/documentation/latest/mesos-roadmap/
publish/documentation/latest/reporting-a-bug/
publish/documentation/latest/submitting-a-patch/ publis...
Author: bmahler
Date: Thu Apr 23 19:38:40 2015
New Revision: 1675709
URL: http://svn.apache.org/r1675709
Log:
Documentation updates from git.
Added:
mesos/site/publish/documentation/latest/reporting-a-bug/
mesos/site/publish/documentation/latest/reporting-a-bug/index.html
mesos/site/publish/documentation/latest/submitting-a-patch/
mesos/site/publish/documentation/latest/submitting-a-patch/index.html
mesos/site/publish/documentation/reporting-a-bug/
mesos/site/publish/documentation/reporting-a-bug/index.html
mesos/site/publish/documentation/submitting-a-patch/
mesos/site/publish/documentation/submitting-a-patch/index.html
mesos/site/source/documentation/latest/reporting-a-bug.md
mesos/site/source/documentation/latest/submitting-a-patch.md
Modified:
mesos/site/publish/documentation/index.html
mesos/site/publish/documentation/latest/index.html
mesos/site/publish/documentation/latest/mesos-roadmap/index.html
mesos/site/publish/documentation/mesos-roadmap/index.html
mesos/site/publish/sitemap.xml
mesos/site/source/documentation/latest.html.md
mesos/site/source/documentation/latest/mesos-roadmap.md
Modified: mesos/site/publish/documentation/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/index.html?rev=1675709&r1=1675708&r2=1675709&view=diff
==============================================================================
--- mesos/site/publish/documentation/index.html (original)
+++ mesos/site/publish/documentation/index.html Thu Apr 23 19:38:40 2015
@@ -136,11 +136,11 @@
<h2>Contributing to Mesos</h2>
<ul>
+<li><a href="/documentation/latest/reporting-a-bug/">Reporting an Issue, Improvement, or Feature</a> for getting started with JIRA.</li>
+<li><a href="/documentation/latest/submitting-a-patch/">Submitting a Patch</a> for getting started with ReviewBoard, and our tooling around it.</li>
<li><a href="/documentation/latest/committers-guide/">Committer’s Guide</a> a guiding document for etiquette in reviews and commits.</li>
-<li><a href="/documentation/latest/mesos-code-internals/">Code Internals</a> an overview of the codebase and internal organization.</li>
<li><a href="/documentation/latest/mesos-c++-style-guide/">C++ Style Guide</a></li>
-<li><a href="/documentation/latest/mesos-developers-guide/">Developers Guide</a> includes resources for developers contributing to Mesos and the process of submitting patches for review.</li>
-<li><a href="/documentation/latest/mesos-roadmap/">Development Road Map</a></li>
+<li><a href="/documentation/latest/mesos-roadmap/">Development Roadmap</a></li>
<li><a href="/documentation/latest/release-guide/">Release Guide</a></li>
</ul>
Modified: mesos/site/publish/documentation/latest/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/index.html?rev=1675709&r1=1675708&r2=1675709&view=diff
==============================================================================
--- mesos/site/publish/documentation/latest/index.html (original)
+++ mesos/site/publish/documentation/latest/index.html Thu Apr 23 19:38:40 2015
@@ -136,11 +136,11 @@
<h2>Contributing to Mesos</h2>
<ul>
+<li><a href="/documentation/latest/reporting-a-bug/">Reporting an Issue, Improvement, or Feature</a> for getting started with JIRA.</li>
+<li><a href="/documentation/latest/submitting-a-patch/">Submitting a Patch</a> for getting started with ReviewBoard, and our tooling around it.</li>
<li><a href="/documentation/latest/committers-guide/">Committer’s Guide</a> a guiding document for etiquette in reviews and commits.</li>
-<li><a href="/documentation/latest/mesos-code-internals/">Code Internals</a> an overview of the codebase and internal organization.</li>
<li><a href="/documentation/latest/mesos-c++-style-guide/">C++ Style Guide</a></li>
-<li><a href="/documentation/latest/mesos-developers-guide/">Developers Guide</a> includes resources for developers contributing to Mesos and the process of submitting patches for review.</li>
-<li><a href="/documentation/latest/mesos-roadmap/">Development Road Map</a></li>
+<li><a href="/documentation/latest/mesos-roadmap/">Development Roadmap</a></li>
<li><a href="/documentation/latest/release-guide/">Release Guide</a></li>
</ul>
Modified: mesos/site/publish/documentation/latest/mesos-roadmap/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/mesos-roadmap/index.html?rev=1675709&r1=1675708&r2=1675709&view=diff
==============================================================================
--- mesos/site/publish/documentation/latest/mesos-roadmap/index.html (original)
+++ mesos/site/publish/documentation/latest/mesos-roadmap/index.html Thu Apr 23 19:38:40 2015
@@ -83,9 +83,13 @@
<div class="col-md-8">
<h1>Mesos Roadmap</h1>
-<p>The <a href="https://issues.apache.org/jira/browse/MESOS#selectedTab=com.atlassian.jira.plugin.system.project%3Aroadmap-panel">Mesos JIRA Road Map</a> provides the most up-to-date information regarding what is planned in future releases.</p>
+<p>The <a href="https://issues.apache.org/jira/browse/MESOS/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel">Mesos JIRA Road Map</a> provides a view of which tickets are targeted for upcoming releases.</p>
-<p>If you have comments or suggestions, you may direct them to the Mesos dev list (dev@mesos.apache.org), or assign issues to future releases.</p>
+<p>The <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20MESOS%20AND%20resolution%20%3D%20Unresolved%20AND%20issuetype%20%3D%20Epic%20ORDER%20BY%20priority%20DESC">‘Epic’ issues in JIRA</a> provide a view into the larger projects planned to be worked on.</p>
+
+<p>There is also an ad-hoc <a href="https://cwiki.apache.org/confluence/display/MESOS/Mesos+Release+Planning">Release Planning</a> document that attempts to capture times and features for upcoming releases.</p>
+
+<p>If you have comments or suggestions, feel free to reach out to the Mesos dev list (dev@mesos.apache.org).</p>
</div>
</div>
Added: mesos/site/publish/documentation/latest/reporting-a-bug/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/reporting-a-bug/index.html?rev=1675709&view=auto
==============================================================================
--- mesos/site/publish/documentation/latest/reporting-a-bug/index.html (added)
+++ mesos/site/publish/documentation/latest/reporting-a-bug/index.html Thu Apr 23 19:38:40 2015
@@ -0,0 +1,113 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title></title>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <link href="//netdna.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap.min.css" rel="stylesheet">
+ <link rel="alternate" type="application/atom+xml" title="Apache Mesos Blog" href="/blog/feed.xml">
+
+ <link href="../../../assets/css/main.css" media="screen" rel="stylesheet" type="text/css" />
+
+
+
+ <!-- Google Analytics Magic -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-20226872-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <!-- magical breadcrumbs -->
+ <div class="topnav">
+ <ul class="breadcrumb">
+ <li>
+ <div class="dropdown">
+ <a data-toggle="dropdown" href="#">Apache Software Foundation <span class="caret"></span></a>
+ <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel">
+ <li><a href="http://www.apache.org">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ </li>
+ <li><a href="http://mesos.apache.org">Apache Mesos</a></li>
+
+
+ <li><a href="/documentation
+/">Documentation
+</a></li>
+
+
+ </ul><!-- /breadcrumb -->
+ </div>
+
+ <!-- navbar excitement -->
+ <div class="navbar navbar-static-top" role="navigation">
+ <div class="navbar-inner">
+ <div class="container">
+ <a href="/" class="logo"><img src="/assets/img/mesos_logo.png" alt="Apache Mesos logo" /></a>
+ <div class="nav-collapse">
+ <ul class="nav nav-pills navbar-right">
+ <li><a href="/gettingstarted/">Getting Started</a></li>
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Community</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div><!-- /.navbar -->
+
+ <div class="container">
+
+ <div class="row-fluid">
+ <div class="col-md-4">
+ <h4>If you're new to Mesos</h4>
+ <p>See the <a href="/gettingstarted/">getting started</a> page for more information about downloading, building, and deploying Mesos.</p>
+
+ <h4>If you'd like to get involved or you're looking for support</h4>
+ <p>See our <a href="/community/">community</a> page for more details.</p>
+ </div>
+ <div class="col-md-8">
+ <h1>Reporting an issue</h1>
+
+<p>When reporting an issue (e.g. bug, improvement, feature request), please provide as much context as possible.</p>
+
+<ul>
+<li>We track all issues via Apache’s hosted <a href="https://issues.apache.org/jira/browse/MESOS">JIRA issue tracker</a>, so if you don’t already have an account you’ll need to register for one. It’s quick and easy.</li>
+<li>A JIRA should be created for every task, feature, bug-fix, etc. This makes it easy to track progress.</li>
+<li>If you are planning to work on the ticket, please assign the JIRA issue to yourself before you start working on it. This helps to avoid duplication of work, and alerts anyone who is following that issue. It is highly encouraged to start a discussion with others in the community about how to solve the issue.</li>
+</ul>
+
+
+ </div>
+</div>
+
+
+ <hr>
+
+ <!-- footer -->
+ <div class="footer">
+ <p>© 2012-2014 <a href="http://apache.org">The Apache Software Foundation</a>.
+ Apache Mesos, the Apache feather logo, and the Apache Mesos project logo are trademarks of The Apache Software Foundation.<p>
+ </div><!-- /footer -->
+
+ </div> <!-- /container -->
+
+ <!-- JS -->
+ <script src="//code.jquery.com/jquery-1.11.0.min.js" type="text/javascript"></script>
+ <script src="//netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js" type="text/javascript"></script>
+ </body>
+</html>
\ No newline at end of file
Added: mesos/site/publish/documentation/latest/submitting-a-patch/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/submitting-a-patch/index.html?rev=1675709&view=auto
==============================================================================
--- mesos/site/publish/documentation/latest/submitting-a-patch/index.html (added)
+++ mesos/site/publish/documentation/latest/submitting-a-patch/index.html Thu Apr 23 19:38:40 2015
@@ -0,0 +1,203 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title></title>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <link href="//netdna.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap.min.css" rel="stylesheet">
+ <link rel="alternate" type="application/atom+xml" title="Apache Mesos Blog" href="/blog/feed.xml">
+
+ <link href="../../../assets/css/main.css" media="screen" rel="stylesheet" type="text/css" />
+
+
+
+ <!-- Google Analytics Magic -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-20226872-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <!-- magical breadcrumbs -->
+ <div class="topnav">
+ <ul class="breadcrumb">
+ <li>
+ <div class="dropdown">
+ <a data-toggle="dropdown" href="#">Apache Software Foundation <span class="caret"></span></a>
+ <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel">
+ <li><a href="http://www.apache.org">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ </li>
+ <li><a href="http://mesos.apache.org">Apache Mesos</a></li>
+
+
+ <li><a href="/documentation
+/">Documentation
+</a></li>
+
+
+ </ul><!-- /breadcrumb -->
+ </div>
+
+ <!-- navbar excitement -->
+ <div class="navbar navbar-static-top" role="navigation">
+ <div class="navbar-inner">
+ <div class="container">
+ <a href="/" class="logo"><img src="/assets/img/mesos_logo.png" alt="Apache Mesos logo" /></a>
+ <div class="nav-collapse">
+ <ul class="nav nav-pills navbar-right">
+ <li><a href="/gettingstarted/">Getting Started</a></li>
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Community</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div><!-- /.navbar -->
+
+ <div class="container">
+
+ <div class="row-fluid">
+ <div class="col-md-4">
+ <h4>If you're new to Mesos</h4>
+ <p>See the <a href="/gettingstarted/">getting started</a> page for more information about downloading, building, and deploying Mesos.</p>
+
+ <h4>If you'd like to get involved or you're looking for support</h4>
+ <p>See our <a href="/community/">community</a> page for more details.</p>
+ </div>
+ <div class="col-md-8">
+ <h1>Submitting a patch</h1>
+
+<ul>
+<li>You’ve fixed a bug or added a feature and want to contribute it. AWESOME!</li>
+<li>We use <a href="https://reviews.apache.org">Apache Review Board</a> for code reviews. If you don’t already have an account, you’ll need to create one (it’s separate from your Apache JIRA account).</li>
+<li>A code review request should be created for every JIRA that involves a change to the codebase.</li>
+</ul>
+
+
+<h3>Before you submit</h3>
+
+<ol>
+<li><p>Check out the code from the Apache repository via Git. Instructions are on the <a href="http://mesos.apache.org/gettingstarted/">Getting Started</a> page.</p></li>
+<li><p>Join the dev, issues, reviews and builds mailing lists by sending emails to dev-subscribe@mesos.apache.org, issues-subscribe@mesos.apache.org, reviews-subscribe@mesos.apache.org and builds-subscribe@mesos.apache.org respectively.</p></li>
+<li><p>Find a JIRA that is currently unassigned that you want to work on at <a href="https://issues.apache.org/jira/browse/MESOS">JIRA issue tracker</a>, or create your own (you’ll need a JIRA account for this, see below)!</p>
+
+<ol>
+<li>This could be a JIRA representing a bug (possibly a bug that you encountered and reported, e.g. when trying to build) or a new feature.</li>
+</ol>
+</li>
+<li><p>Assign the JIRA to yourself. To do this, you will need:</p>
+
+<ol>
+<li>An Apache JIRA user account (sign up for one <a href="https://issues.apache.org/jira/secure/Signup!default.jspa">here</a>).</li>
+<li>You need to be added to the list of Mesos “contributors” by a Mesos committer (send email to dev@mesos.apache.org) in order to be assigned (or to assign yourself) to a JIRA issue.</li>
+</ol>
+</li>
+<li><p>Formulate a plan for resolving the issue, propose your plan via comments in the JIRA.</p></li>
+<li><p>Create one or more test cases to exercise the bug or the feature (the Mesos team uses <a href="http://en.wikipedia.org/wiki/Test-driven_development">test-driven development</a>), before you start coding, make sure these test cases all fail.</p></li>
+<li><p>Make your changes to the code (using whatever IDE/editor you choose) to actually fix the bug or implement the feature.</p>
+
+<ol>
+<li>Before beginning, please read the <a href="/documentation/latest/mesos-c++-style-guide/">Mesos C++ Style Guide</a>. It is recommended to use the git pre-commit hook (<code>support/hooks/pre-commit</code>) to automatically check for style errors. See the hook script for instructions to enable it.</li>
+<li>Most of your changes will probably be to files inside of <code>BASE_MESOS_DIR</code></li>
+<li>To build, we recommend that you don’t build inside of the src directory. We recommend you do the following:
+
+<ol>
+<li>From inside of the root Mesos directory: <code>mkdir build && cd build</code></li>
+<li><code>../configure</code></li>
+<li><code>make</code></li>
+<li>Now all of the files generated by the build process will be contained in the build directory you created, instead of being spread throughout the src directory, which is a bit messier. This is both cleaner, and makes it easy to clean up if you want to get rid of the files generated by <code>configure</code> and <code>make</code>. I.e. You can reset your build process without risking changes you made in the src directory, by simply deleting the build directory, and creating a new one.</li>
+</ol>
+</li>
+</ol>
+</li>
+<li><p>Make sure all of your test cases now pass.</p>
+
+<ol>
+<li><code>make check</code></li>
+</ol>
+</li>
+<li><p>Make sure to pull in any changes that have been committed to master branch. Using Git, do this via something like:</p>
+
+<ol>
+<li><code>git checkout master</code></li>
+<li><code>git pull</code></li>
+<li><code>git checkout my_branch</code></li>
+<li>Check the output of <code>git diff master</code> and make sure it lists only your changes. If other changes you did not make are listed, try <code>git rebase master</code> to bring your branch up to date with master.</li>
+</ol>
+</li>
+</ol>
+
+
+<h3>Submit your patch</h3>
+
+<ol>
+<li><p>You’re ready to submit your patch for review!</p>
+
+<ol>
+<li>Log in or create an account at <a href="http://reviews.apache.org">Apache Review Board</a></li>
+<li>The easiest (and recommended) way to submit reviews is through <code>post-reviews.py</code> a wrapper around post-review.</li>
+<li>First, install RBTools. <a href="https://www.reviewboard.org/docs/rbtools/dev/">See Instructions</a></li>
+<li>Configure post-review. The easiest method is to symlink to the sample config: ln -s support/reviewboardrc .reviewboardrc</li>
+<li>Log into Review Board from the command line: run <code>rbt status</code></li>
+<li>From your local branch run <code>support/post-reviews.py</code>.</li>
+<li>Note that <code>post-reviews.py</code> creates a new review for every commit on your branch that is different from the <code>master</code>.</li>
+<li>Be sure to add your JIRA issue id (e.g. MESOS-01) to the field labeled “Bugs” (this will automatically link)</li>
+<li>Under “Description” in addition to details about your changes, include a description of any documentation pages that need to be added, or are affected by your changes (e.g. did you change or add any configuration options/flags? Did you add a new binary?)</li>
+</ol>
+</li>
+<li><p>Wait for a code review from another Mesos developer via Review Board, address their feedback and upload updated patches until you receive a “Ship It” from a Mesos committer.</p>
+
+<ol>
+<li>When addressing feedback, adjust your existing commit(s) instead of creating new commits, otherwise <code>post-reviews.py</code> will create a new review (<code>git rebase -i</code> is your friend).</li>
+<li>Review Board comments should be used for code-specific discussions, and JIRA comments for bigger-picture design discussions.</li>
+<li>Always respond to each RB comment that you address directly (i.e. each comment can be responded to directly) with either “Done.” or a comment explaining how you addressed it.</li>
+<li>If an issue has been raised in the review, please resolve the issue as “Fixed” or “Dropped”. If “Dropped” please add a comment explaining the reason. Also, if your fix warrants a comment (e.g., fixed differently than suggested by the reviewer) please add a comment.</li>
+</ol>
+</li>
+<li><p>After consensus is reached on your JIRA/patch, you’re review request will receive a “Ship It!” from a committer, and then a committer will commit your patch to the git repository. Congratulations and thanks for participating in our community!</p></li>
+<li><p>The last step is to ensure that the necessary documentation gets created or updated so the whole world knows about your new feature or bug fix.</p></li>
+</ol>
+
+
+<h2>Style Guides</h2>
+
+<ul>
+<li>For patches to the core, we ask that you follow the <a href="/documentation/latest/mesos-c++-style-guide/">Mesos C++ Style Guide</a></li>
+</ul>
+
+
+ </div>
+</div>
+
+
+ <hr>
+
+ <!-- footer -->
+ <div class="footer">
+ <p>© 2012-2014 <a href="http://apache.org">The Apache Software Foundation</a>.
+ Apache Mesos, the Apache feather logo, and the Apache Mesos project logo are trademarks of The Apache Software Foundation.<p>
+ </div><!-- /footer -->
+
+ </div> <!-- /container -->
+
+ <!-- JS -->
+ <script src="//code.jquery.com/jquery-1.11.0.min.js" type="text/javascript"></script>
+ <script src="//netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js" type="text/javascript"></script>
+ </body>
+</html>
\ No newline at end of file
Modified: mesos/site/publish/documentation/mesos-roadmap/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/mesos-roadmap/index.html?rev=1675709&r1=1675708&r2=1675709&view=diff
==============================================================================
--- mesos/site/publish/documentation/mesos-roadmap/index.html (original)
+++ mesos/site/publish/documentation/mesos-roadmap/index.html Thu Apr 23 19:38:40 2015
@@ -83,9 +83,13 @@
<div class="col-md-8">
<h1>Mesos Roadmap</h1>
-<p>The <a href="https://issues.apache.org/jira/browse/MESOS#selectedTab=com.atlassian.jira.plugin.system.project%3Aroadmap-panel">Mesos JIRA Road Map</a> provides the most up-to-date information regarding what is planned in future releases.</p>
+<p>The <a href="https://issues.apache.org/jira/browse/MESOS/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel">Mesos JIRA Road Map</a> provides a view of which tickets are targeted for upcoming releases.</p>
-<p>If you have comments or suggestions, you may direct them to the Mesos dev list (dev@mesos.apache.org), or assign issues to future releases.</p>
+<p>The <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20MESOS%20AND%20resolution%20%3D%20Unresolved%20AND%20issuetype%20%3D%20Epic%20ORDER%20BY%20priority%20DESC">‘Epic’ issues in JIRA</a> provide a view into the larger projects planned to be worked on.</p>
+
+<p>There is also an ad-hoc <a href="https://cwiki.apache.org/confluence/display/MESOS/Mesos+Release+Planning">Release Planning</a> document that attempts to capture times and features for upcoming releases.</p>
+
+<p>If you have comments or suggestions, feel free to reach out to the Mesos dev list (dev@mesos.apache.org).</p>
</div>
</div>
Added: mesos/site/publish/documentation/reporting-a-bug/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/reporting-a-bug/index.html?rev=1675709&view=auto
==============================================================================
--- mesos/site/publish/documentation/reporting-a-bug/index.html (added)
+++ mesos/site/publish/documentation/reporting-a-bug/index.html Thu Apr 23 19:38:40 2015
@@ -0,0 +1,113 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title></title>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <link href="//netdna.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap.min.css" rel="stylesheet">
+ <link rel="alternate" type="application/atom+xml" title="Apache Mesos Blog" href="/blog/feed.xml">
+
+ <link href="../../assets/css/main.css" media="screen" rel="stylesheet" type="text/css" />
+
+
+
+ <!-- Google Analytics Magic -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-20226872-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <!-- magical breadcrumbs -->
+ <div class="topnav">
+ <ul class="breadcrumb">
+ <li>
+ <div class="dropdown">
+ <a data-toggle="dropdown" href="#">Apache Software Foundation <span class="caret"></span></a>
+ <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel">
+ <li><a href="http://www.apache.org">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ </li>
+ <li><a href="http://mesos.apache.org">Apache Mesos</a></li>
+
+
+ <li><a href="/documentation
+/">Documentation
+</a></li>
+
+
+ </ul><!-- /breadcrumb -->
+ </div>
+
+ <!-- navbar excitement -->
+ <div class="navbar navbar-static-top" role="navigation">
+ <div class="navbar-inner">
+ <div class="container">
+ <a href="/" class="logo"><img src="/assets/img/mesos_logo.png" alt="Apache Mesos logo" /></a>
+ <div class="nav-collapse">
+ <ul class="nav nav-pills navbar-right">
+ <li><a href="/gettingstarted/">Getting Started</a></li>
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Community</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div><!-- /.navbar -->
+
+ <div class="container">
+
+ <div class="row-fluid">
+ <div class="col-md-4">
+ <h4>If you're new to Mesos</h4>
+ <p>See the <a href="/gettingstarted/">getting started</a> page for more information about downloading, building, and deploying Mesos.</p>
+
+ <h4>If you'd like to get involved or you're looking for support</h4>
+ <p>See our <a href="/community/">community</a> page for more details.</p>
+ </div>
+ <div class="col-md-8">
+ <h1>Reporting an issue</h1>
+
+<p>When reporting an issue (e.g. bug, improvement, feature request), please provide as much context as possible.</p>
+
+<ul>
+<li>We track all issues via Apache’s hosted <a href="https://issues.apache.org/jira/browse/MESOS">JIRA issue tracker</a>, so if you don’t already have an account you’ll need to register for one. It’s quick and easy.</li>
+<li>A JIRA should be created for every task, feature, bug-fix, etc. This makes it easy to track progress.</li>
+<li>If you are planning to work on the ticket, please assign the JIRA issue to yourself before you start working on it. This helps to avoid duplication of work, and alerts anyone who is following that issue. It is highly encouraged to start a discussion with others in the community about how to solve the issue.</li>
+</ul>
+
+
+ </div>
+</div>
+
+
+ <hr>
+
+ <!-- footer -->
+ <div class="footer">
+ <p>© 2012-2014 <a href="http://apache.org">The Apache Software Foundation</a>.
+ Apache Mesos, the Apache feather logo, and the Apache Mesos project logo are trademarks of The Apache Software Foundation.<p>
+ </div><!-- /footer -->
+
+ </div> <!-- /container -->
+
+ <!-- JS -->
+ <script src="//code.jquery.com/jquery-1.11.0.min.js" type="text/javascript"></script>
+ <script src="//netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js" type="text/javascript"></script>
+ </body>
+</html>
\ No newline at end of file
Added: mesos/site/publish/documentation/submitting-a-patch/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/submitting-a-patch/index.html?rev=1675709&view=auto
==============================================================================
--- mesos/site/publish/documentation/submitting-a-patch/index.html (added)
+++ mesos/site/publish/documentation/submitting-a-patch/index.html Thu Apr 23 19:38:40 2015
@@ -0,0 +1,203 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title></title>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <link href="//netdna.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap.min.css" rel="stylesheet">
+ <link rel="alternate" type="application/atom+xml" title="Apache Mesos Blog" href="/blog/feed.xml">
+
+ <link href="../../assets/css/main.css" media="screen" rel="stylesheet" type="text/css" />
+
+
+
+ <!-- Google Analytics Magic -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-20226872-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <!-- magical breadcrumbs -->
+ <div class="topnav">
+ <ul class="breadcrumb">
+ <li>
+ <div class="dropdown">
+ <a data-toggle="dropdown" href="#">Apache Software Foundation <span class="caret"></span></a>
+ <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel">
+ <li><a href="http://www.apache.org">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ </li>
+ <li><a href="http://mesos.apache.org">Apache Mesos</a></li>
+
+
+ <li><a href="/documentation
+/">Documentation
+</a></li>
+
+
+ </ul><!-- /breadcrumb -->
+ </div>
+
+ <!-- navbar excitement -->
+ <div class="navbar navbar-static-top" role="navigation">
+ <div class="navbar-inner">
+ <div class="container">
+ <a href="/" class="logo"><img src="/assets/img/mesos_logo.png" alt="Apache Mesos logo" /></a>
+ <div class="nav-collapse">
+ <ul class="nav nav-pills navbar-right">
+ <li><a href="/gettingstarted/">Getting Started</a></li>
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Community</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div><!-- /.navbar -->
+
+ <div class="container">
+
+ <div class="row-fluid">
+ <div class="col-md-4">
+ <h4>If you're new to Mesos</h4>
+ <p>See the <a href="/gettingstarted/">getting started</a> page for more information about downloading, building, and deploying Mesos.</p>
+
+ <h4>If you'd like to get involved or you're looking for support</h4>
+ <p>See our <a href="/community/">community</a> page for more details.</p>
+ </div>
+ <div class="col-md-8">
+ <h1>Submitting a patch</h1>
+
+<ul>
+<li>You’ve fixed a bug or added a feature and want to contribute it. AWESOME!</li>
+<li>We use <a href="https://reviews.apache.org">Apache Review Board</a> for code reviews. If you don’t already have an account, you’ll need to create one (it’s separate from your Apache JIRA account).</li>
+<li>A code review request should be created for every JIRA that involves a change to the codebase.</li>
+</ul>
+
+
+<h3>Before you submit</h3>
+
+<ol>
+<li><p>Check out the code from the Apache repository via Git. Instructions are on the <a href="http://mesos.apache.org/gettingstarted/">Getting Started</a> page.</p></li>
+<li><p>Join the dev, issues, reviews and builds mailing lists by sending emails to dev-subscribe@mesos.apache.org, issues-subscribe@mesos.apache.org, reviews-subscribe@mesos.apache.org and builds-subscribe@mesos.apache.org respectively.</p></li>
+<li><p>Find a JIRA that is currently unassigned that you want to work on at <a href="https://issues.apache.org/jira/browse/MESOS">JIRA issue tracker</a>, or create your own (you’ll need a JIRA account for this, see below)!</p>
+
+<ol>
+<li>This could be a JIRA representing a bug (possibly a bug that you encountered and reported, e.g. when trying to build) or a new feature.</li>
+</ol>
+</li>
+<li><p>Assign the JIRA to yourself. To do this, you will need:</p>
+
+<ol>
+<li>An Apache JIRA user account (sign up for one <a href="https://issues.apache.org/jira/secure/Signup!default.jspa">here</a>).</li>
+<li>You need to be added to the list of Mesos “contributors” by a Mesos committer (send email to dev@mesos.apache.org) in order to be assigned (or to assign yourself) to a JIRA issue.</li>
+</ol>
+</li>
+<li><p>Formulate a plan for resolving the issue, propose your plan via comments in the JIRA.</p></li>
+<li><p>Create one or more test cases to exercise the bug or the feature (the Mesos team uses <a href="http://en.wikipedia.org/wiki/Test-driven_development">test-driven development</a>), before you start coding, make sure these test cases all fail.</p></li>
+<li><p>Make your changes to the code (using whatever IDE/editor you choose) to actually fix the bug or implement the feature.</p>
+
+<ol>
+<li>Before beginning, please read the <a href="/documentation/latest/mesos-c++-style-guide/">Mesos C++ Style Guide</a>. It is recommended to use the git pre-commit hook (<code>support/hooks/pre-commit</code>) to automatically check for style errors. See the hook script for instructions to enable it.</li>
+<li>Most of your changes will probably be to files inside of <code>BASE_MESOS_DIR</code></li>
+<li>To build, we recommend that you don’t build inside of the src directory. We recommend you do the following:
+
+<ol>
+<li>From inside of the root Mesos directory: <code>mkdir build && cd build</code></li>
+<li><code>../configure</code></li>
+<li><code>make</code></li>
+<li>Now all of the files generated by the build process will be contained in the build directory you created, instead of being spread throughout the src directory, which is a bit messier. This is both cleaner, and makes it easy to clean up if you want to get rid of the files generated by <code>configure</code> and <code>make</code>. I.e. You can reset your build process without risking changes you made in the src directory, by simply deleting the build directory, and creating a new one.</li>
+</ol>
+</li>
+</ol>
+</li>
+<li><p>Make sure all of your test cases now pass.</p>
+
+<ol>
+<li><code>make check</code></li>
+</ol>
+</li>
+<li><p>Make sure to pull in any changes that have been committed to master branch. Using Git, do this via something like:</p>
+
+<ol>
+<li><code>git checkout master</code></li>
+<li><code>git pull</code></li>
+<li><code>git checkout my_branch</code></li>
+<li>Check the output of <code>git diff master</code> and make sure it lists only your changes. If other changes you did not make are listed, try <code>git rebase master</code> to bring your branch up to date with master.</li>
+</ol>
+</li>
+</ol>
+
+
+<h3>Submit your patch</h3>
+
+<ol>
+<li><p>You’re ready to submit your patch for review!</p>
+
+<ol>
+<li>Log in or create an account at <a href="http://reviews.apache.org">Apache Review Board</a></li>
+<li>The easiest (and recommended) way to submit reviews is through <code>post-reviews.py</code> a wrapper around post-review.</li>
+<li>First, install RBTools. <a href="https://www.reviewboard.org/docs/rbtools/dev/">See Instructions</a></li>
+<li>Configure post-review. The easiest method is to symlink to the sample config: ln -s support/reviewboardrc .reviewboardrc</li>
+<li>Log into Review Board from the command line: run <code>rbt status</code></li>
+<li>From your local branch run <code>support/post-reviews.py</code>.</li>
+<li>Note that <code>post-reviews.py</code> creates a new review for every commit on your branch that is different from the <code>master</code>.</li>
+<li>Be sure to add your JIRA issue id (e.g. MESOS-01) to the field labeled “Bugs” (this will automatically link)</li>
+<li>Under “Description” in addition to details about your changes, include a description of any documentation pages that need to be added, or are affected by your changes (e.g. did you change or add any configuration options/flags? Did you add a new binary?)</li>
+</ol>
+</li>
+<li><p>Wait for a code review from another Mesos developer via Review Board, address their feedback and upload updated patches until you receive a “Ship It” from a Mesos committer.</p>
+
+<ol>
+<li>When addressing feedback, adjust your existing commit(s) instead of creating new commits, otherwise <code>post-reviews.py</code> will create a new review (<code>git rebase -i</code> is your friend).</li>
+<li>Review Board comments should be used for code-specific discussions, and JIRA comments for bigger-picture design discussions.</li>
+<li>Always respond to each RB comment that you address directly (i.e. each comment can be responded to directly) with either “Done.” or a comment explaining how you addressed it.</li>
+<li>If an issue has been raised in the review, please resolve the issue as “Fixed” or “Dropped”. If “Dropped” please add a comment explaining the reason. Also, if your fix warrants a comment (e.g., fixed differently than suggested by the reviewer) please add a comment.</li>
+</ol>
+</li>
+<li><p>After consensus is reached on your JIRA/patch, you’re review request will receive a “Ship It!” from a committer, and then a committer will commit your patch to the git repository. Congratulations and thanks for participating in our community!</p></li>
+<li><p>The last step is to ensure that the necessary documentation gets created or updated so the whole world knows about your new feature or bug fix.</p></li>
+</ol>
+
+
+<h2>Style Guides</h2>
+
+<ul>
+<li>For patches to the core, we ask that you follow the <a href="/documentation/latest/mesos-c++-style-guide/">Mesos C++ Style Guide</a></li>
+</ul>
+
+
+ </div>
+</div>
+
+
+ <hr>
+
+ <!-- footer -->
+ <div class="footer">
+ <p>© 2012-2014 <a href="http://apache.org">The Apache Software Foundation</a>.
+ Apache Mesos, the Apache feather logo, and the Apache Mesos project logo are trademarks of The Apache Software Foundation.<p>
+ </div><!-- /footer -->
+
+ </div> <!-- /container -->
+
+ <!-- JS -->
+ <script src="//code.jquery.com/jquery-1.11.0.min.js" type="text/javascript"></script>
+ <script src="//netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js" type="text/javascript"></script>
+ </body>
+</html>
\ No newline at end of file