You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/06/16 08:32:16 UTC

svn commit: r1685718 [47/47] - in /isis/site/trunk/content: ./ css/ css/asciidoctor/ css/font-awesome/ css/font-awesome/4.3.0/ css/font-awesome/4.3.0/css/ css/font-awesome/4.3.0/fonts/ css/font-awesome/4.3.0/less/ css/font-awesome/4.3.0/scss/ css/found...

Added: isis/site/trunk/content/verifying-releases-using-creadur-tools.html
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/verifying-releases-using-creadur-tools.html?rev=1685718&view=auto
==============================================================================
--- isis/site/trunk/content/verifying-releases-using-creadur-tools.html (added)
+++ isis/site/trunk/content/verifying-releases-using-creadur-tools.html Tue Jun 16 06:32:10 2015
@@ -0,0 +1,817 @@
+<!doctype html>

+<html class="no-js" lang="en">

+<head>

+    <meta charset="utf-8"/>

+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>

+

+    <title>Verifying Releases using Creadur Tools</title>

+

+    <!--

+        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.

+    -->

+

+    <!-- No caching headers -->

+    <meta http-equiv="cache-control" content="no-cache" />

+    <meta http-equiv="pragma" content="no-cache" />

+    <meta http-equiv="expires" content="-1" />

+

+

+    <!-- TODO: need to (re)instate CDN in the future (not using for now just so can develop off-line -->

+    <link href="./css/foundation/5.5.1/foundation.css" rel="stylesheet" />

+    <script src="./js/foundation/5.5.1/vendor/modernizr.js"></script>

+    <link href="./css/asciidoctor/colony.css" rel="stylesheet">

+    <link href="./css/font-awesome/4.3.0/css/font-awesome.min.css" rel="stylesheet">

+

+

+

+

+    <link href="./css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.css" rel="stylesheet" />

+    <!--[if lt IE 9]>

+      <link href="./css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.ie.css" rel="stylesheet" />

+    <![endif]-->

+

+

+    <style type="text/css">

+        /* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
+/*pre.CodeRay {background-color:#f7f7f8;}*/
+.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em}
+.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)}
+.CodeRay .line-numbers strong{font-weight: normal}
+table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none}
+table.CodeRay td{vertical-align: top}
+table.CodeRay td.line-numbers{text-align:right}
+table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)}
+table.CodeRay td.code{padding:0 0 0 .5em}
+table.CodeRay td.code>pre{padding:0}
+.CodeRay .debug{color:#fff !important;background:#000080 !important}
+.CodeRay .annotation{color:#007}
+.CodeRay .attribute-name{color:#000080}
+.CodeRay .attribute-value{color:#700}
+.CodeRay .binary{color:#509}
+.CodeRay .comment{color:#998;font-style:italic}
+.CodeRay .char{color:#04d}
+.CodeRay .char .content{color:#04d}
+.CodeRay .char .delimiter{color:#039}
+.CodeRay .class{color:#458;font-weight:bold}
+.CodeRay .complex{color:#a08}
+.CodeRay .constant,.CodeRay .predefined-constant{color:#008080}
+.CodeRay .color{color:#099}
+.CodeRay .class-variable{color:#369}
+.CodeRay .decorator{color:#b0b}
+.CodeRay .definition{color:#099}
+.CodeRay .delimiter{color:#000}
+.CodeRay .doc{color:#970}
+.CodeRay .doctype{color:#34b}
+.CodeRay .doc-string{color:#d42}
+.CodeRay .escape{color:#666}
+.CodeRay .entity{color:#800}
+.CodeRay .error{color:#808}
+.CodeRay .exception{color:inherit}
+.CodeRay .filename{color:#099}
+.CodeRay .function{color:#900;font-weight:bold}
+.CodeRay .global-variable{color:#008080}
+.CodeRay .hex{color:#058}
+.CodeRay .integer,.CodeRay .float{color:#099}
+.CodeRay .include{color:#555}
+.CodeRay .inline{color:#00}
+.CodeRay .inline .inline{background:#ccc}
+.CodeRay .inline .inline .inline{background:#bbb}
+.CodeRay .inline .inline-delimiter{color:#d14}
+.CodeRay .inline-delimiter{color:#d14}
+.CodeRay .important{color:#555;font-weight:bold}
+.CodeRay .interpreted{color:#b2b}
+.CodeRay .instance-variable{color:#008080}
+.CodeRay .label{color:#970}
+.CodeRay .local-variable{color:#963}
+.CodeRay .octal{color:#40e}
+.CodeRay .predefined{color:#369}
+.CodeRay .preprocessor{color:#579}
+.CodeRay .pseudo-class{color:#555}
+.CodeRay .directive{font-weight:bold}
+.CodeRay .type{font-weight:bold}
+.CodeRay .predefined-type{color:inherit}
+.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold}
+.CodeRay .key{color:#808}
+.CodeRay .key .delimiter{color:#606}
+.CodeRay .key .char{color:#80f}
+.CodeRay .value{color:#088}
+.CodeRay .regexp .delimiter{color:#808}
+.CodeRay .regexp .content{color:#808}
+.CodeRay .regexp .modifier{color:#808}
+.CodeRay .regexp .char{color:#d14}
+.CodeRay .regexp .function{color:#404;font-weight:bold}
+.CodeRay .string{color:#d20}
+.CodeRay .string .string .string{background:#ffd0d0}
+.CodeRay .string .content{color:#d14}
+.CodeRay .string .char{color:#d14}
+.CodeRay .string .delimiter{color:#d14}
+.CodeRay .shell{color:#d14}
+.CodeRay .shell .delimiter{color:#d14}
+.CodeRay .symbol{color:#990073}
+.CodeRay .symbol .content{color:#a60}
+.CodeRay .symbol .delimiter{color:#630}
+.CodeRay .tag{color:#008080}
+.CodeRay .tag-special{color:#d70}
+.CodeRay .variable{color:#036}
+.CodeRay .insert{background:#afa}
+.CodeRay .delete{background:#faa}
+.CodeRay .change{color:#aaf;background:#007}
+.CodeRay .head{color:#f8f;background:#505}
+.CodeRay .insert .insert{color:#080}
+.CodeRay .delete .delete{color:#800}
+.CodeRay .change .change{color:#66f}
+.CodeRay .head .head{color:#f4f}

+

+        pre.CodeRay code {

+            background-color: inherit;

+            border-style: none;

+        }

+

+        pre.CodeRay code > span:first-child {

+            margin-left: -5px;

+        }

+

+        .literalblock pre,

+        .listingblock pre:not(.highlight),

+        .listingblock pre[class="highlight"],

+        .listingblock pre[class^="highlight "],

+        .listingblock pre.CodeRay,

+        .listingblock pre.prettyprint {

+            background: rgb(253, 250, 246);

+         }

+        .sidebarblock .literalblock pre,

+        .sidebarblock .listingblock pre:not(.highlight),

+        .sidebarblock .listingblock pre[class="highlight"],

+        .sidebarblock .listingblock pre[class^="highlight "],

+        .sidebarblock .listingblock pre.CodeRay,

+        .sidebarblock .listingblock pre.prettyprint {

+            background: rgb(253, 250, 246);

+         }

+

+    <style>

+

+    <style>

+    .github-fork-ribbon-wrapper.right {

+        position: fixed;

+    }

+    .github-fork-ribbon {

+        background: #090;

+    }

+    .github-fork-ribbon a:hover {

+        background:#0D0;

+        color:#fff;

+        font-size: 1.1em;

+    }

+    </style>

+

+    <style>

+        @media only screen and (min-width: 40.063em) {

+          .top-bar {

+            .contain-to-grid .top-bar {

+                max-width: 80rem;

+            }

+          }

+        }

+        .row {

+            max-width: 80rem;

+        }

+    </style>

+

+    <style>

+        .extended-quote,

+        .extended-quote-first {

+            margin-left: 40px;

+            margin-right: 40px;

+            font-style: italic;

+        }

+        .extended-quote-attribution {

+            text-align: right;

+            margin-right: 100px;

+            color: #10B061;

+        }

+

+        .extended-quote-first:before {

+            content: "\201c";

+            float: left;

+            font-size: 2.75em;

+            font-weight: bold;

+            line-height: 0.6em;

+            margin-left: -0.6em;

+            color: #003b6b;

+            text-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);

+        }

+    </style>

+

+    <style>

+        body {

+          position: relative;

+        }

+

+        *:not(pre) a > code {

+            color: #210DDC;

+        }

+

+        *:not(pre) > code {

+            background-color: inherit;

+            border: none;

+            font-weight: normal;

+        }

+

+        body div#toc li,

+        body div#toc2 li {

+            list-style-type: none;

+        }

+

+        div#doc-content {

+            margin-top: 30px;

+        }

+

+        body div#toc li.active-region:before,

+        body div#toc2 li.active-region:before {

+            content: "\00BB \0020";

+            margin-left: -12px;

+        }

+

+        body div#toc li a.active,

+        body div#toc2 li a.active {

+            color: red;

+        }

+

+        body div#toc.toc,

+        body div#toc.toc2 {

+            position: fixed;

+            left: auto;

+            padding-top: 60px;

+            z-index: auto;

+            background-color: white;

+            border-left-color: #eee;

+            border-left-style: solid;

+            border-right: none;

+            min-height: 2000px;

+        }

+

+    </style>

+

+    <style>

+

+        @media only screen and (min-width: 768px) {

+          #toc.toc2 ul ul { margin-left: -10px; }

+        }

+

+

+        body div#toc .tocify-subheader ul {

+            margin-bottom: 0px;

+        }

+

+        body div#toc .tocify-subheader li {

+            font-size: 14px;

+        }

+        .tocify li.tocify-item, .tocify ul.tocify-item {

+            line-height: 24px;

+        }

+

+        body div#toc li.tocify-item.active:before,

+        body div#toc2 li.tocify-item.active:before {

+            content: "\00BB \0020";

+            margin-left: -12px;

+        }

+

+        body div#toc li.tocify-item.active a,

+        body div#toc2 li.tocify-item.active a {

+            color: red;

+        }

+    </style>

+

+    <style>

+        footer {

+            margin-top: 1000px;

+        }

+    </style>

+

+    <style>

+        /* overriding colony.css stylesheet */

+        .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] {

+           /*padding: 1.25em 1.5625em 1.125em 1.5625em;*/

+           padding: 0.3em 0.6em 0.25em 0.6em;

+        }

+        @media only screen and (min-width: 1280px)

+        #toc.toc2 {

+          /*width: 20em;*/

+          width: 25em;

+        }

+

+        #doc-content a {

+          color: #210DDC;

+        }

+

+        .top-bar h1 {

+            border-bottom: inherit;

+        }

+

+        h2 {

+          margin-top: 80px;

+        }

+        h3 {

+          margin-top: 40px;

+        }

+        h4,h5 {

+          margin-top: 30px;

+        }

+

+        .admonitionblock.tip > table td.content {

+            color: #10B061;

+        }

+        .admonitionblock.note > table td.content {

+            color: #B509AB;

+        }

+        .admonitionblock.important > table td.content {

+            color: #D5810A;

+        }

+

+        .admonitionblock .title {

+            font-size: larger;

+            font-style: italic;

+        }

+

+        .imageblock img {

+            margin-bottom: 10px;

+        }

+    </style>

+

+    <style>

+        /* from http://ben.balter.com/2014/03/13/pages-anchor-links/ */

+        .header-link {

+          position: absolute;

+          left: -0.5em;

+          opacity: 0;

+

+          /*

+          -webkit-transition: opacity 0.2s ease-in-out 0.1s;

+          -moz-transition: opacity 0.2s ease-in-out 0.1s;

+          -ms-transition: opacity 0.2s ease-in-out 0.1s;

+          */

+        }

+

+        h2:hover .header-link,

+        h3:hover .header-link,

+        h4:hover .header-link,

+        h5:hover .header-link,

+        h6:hover .header-link {

+          opacity: 1;

+        }

+    </style>

+

+    <style>

+        .top-bar

+        {

+            -webkit-transition-duration: .5s;

+            transition-duration: .5s;

+

+            -webkit-transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );

+            transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );

+

+            -webkit-transition-property: -webkit-transform;

+            transition-property: transform;

+        }

+

+        /*

+        http://osvaldas.info/auto-hide-sticky-header

+        MIT license

+        */

+        .header--hidden

+        {

+            -webkit-transform: translateY( -100% );

+            -ms-transform: translateY( -100% );

+            transform: translateY( -100% );

+

+            transition-duration: .5s;

+            transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );

+            -webkit-transition-property: -webkit-transform;

+            transition-property: transform;

+        }

+    </style>

+

+    <style>

+        #doc-content a.guide {

+            color: white;

+        }

+    </style>

+

+    <style>

+        .tocify {

+            margin-top: 80px;

+        }

+    </style>

+

+

+</script>

+

+</head>

+<body>

+

+<<div class="github-fork-ribbon-wrapper right" style="position: fixed;">

+    <div class="github-fork-ribbon">

+        <a href="https://github.com/apache/isis/fork">Fork me on GitHub</a>

+    </div>

+</div>

+

+

+<div class="row">

+

+    <div class="fixed contain-to-grid header">

+        <nav class="top-bar" data-topbar role="navigation" style="max-width: 80rem">

+            <ul class="title-area">

+                <li class="name">

+                    <h1>

+                        <a href="/index.html">Apache Isis&trade;</a>

+                    </h1>

+                </li>

+                <!-- Remove the class "menu-icon" to get rid of menu icon. Take out "Menu" to just have icon alone -->

+                <li class="toggle-topbar menu-icon"><a href="#"><span>Menu</span></a></li>

+            </ul>

+

+            <section class="top-bar-section">

+                <ul class="right">

+

+                    <li class="has-form">

+                       <FORM class="searchbox navbar-form navbar-right" id="searchbox_012614087480249044419:dn-q5gtwxya" action="http://www.google.com/cse">

+                        <div class="row collapse">

+                            <input type="hidden" name="cx" value="012614087480249044419:dn-q5gtwxya">

+                            <INPUT type="hidden" name="cof" value="FORID:0">

+                            <INPUT class="form-control" name="q" type="text" placeholder="Search">

+                        </div>

+                    </FORM>

+                     </li>

+

+                </ul>

+

+                <!-- Left Nav Section -->

+                <ul class="left">

+

+                    <li><a href="/documentation.html">Documentation</a></li>

+                    <li><a href="/downloads.html">Downloads</a></li>

+                    <li><a href="/help.html">Help</a></li>

+                    <li><a href="/asf.html">@ASF</a></li>

+

+                </ul>

+

+            </section>

+        </nav>

+    </div>

+</div>

+

+<div class="row">

+

+    <div id="doc-content-left" class="large-9 medium-9 columns">

+

+

+        <div id="doc-content">

+          <div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p><br/><br/></p>
+</div>
+<div class="paragraph">
+<p>The <a href="http://creadur.apache.org">Apache Creadur</a> project exists to provide a set of tools to ensure compliance with Apache&#8217;s licensing standards. The main release auditing tool, <a href="http://creadur.apache.org/rat">Apache RAT</a>, is used in the preparation of the release (as documented <a href="release-process.html">here</a>). Creadur&#8217;s remaining tools are to support the verification process.</p>
+</div>
+<div class="paragraph">
+<p>At the time of writing, these additional tools are quite young and haven&#8217;t been formally released; so to use them will take a little bit of work. In the future we expect these tools to mature and ease the effort required to verify releases.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_using_the_tentacles_tool">Using the Tentacles tool</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>At the time of writing the Tentacles tool hasn&#8217;t been released, so you&#8217;ll need to build from source:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>mkdir /tmp/verify
+cd /tmp/verify
+svn co http://svn.apache.org/repos/asf/creadur/tentacles/trunk creadur-tentacles
+cd creadur-tentacles
+mvn clean install</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You can pull down a release, using a command such as:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>cd /tmp/verify
+java -jar creadur-tentacles/target/apache-tentacles-0.1-SNAPSHOT.jar https://repository.apache.org/content/repositories/orgapacheisis-NNN/</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>where <code>NNN</code> is the repository that has the staged artifacts requiring verification.</p>
+</div>
+<div class="paragraph">
+<p>As per the <a href="http://creadur.apache.org/tentacles/">tentacles documentation</a>, this command generates a report called <code>archives.html</code> (in the newly created <code>orgapacheisis-NNN</code> directory). This lists all of the top-level binaires, their <code>LICENSE</code> and <code>NOTICE</code> files and any <code>LICENSE</code> and <code>NOTICE</code> files of any binaries they may contain.</p>
+</div>
+<div class="paragraph">
+<p>Validation of the output at this point is all still manual. Things to check for include:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>any binaries that contain no LICENSE and NOTICE files</p>
+</li>
+<li>
+<p>any binaries that contain more than one LICENSE or NOTICE file</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In this report, each binary will have three links listed after its name '(licenses, notices, contents)'</p>
+</div>
+</div>
+</div>

+        </div>

+

+        <footer>

+          <hr>

+          <p class="small">

+          Copyright &copy; 2010~2015 The Apache&nbsp;Software&nbsp;Foundation, licensed under the Apache&nbsp;License,&nbsp;v2.0.

+          <br/>

+          Apache, the Apache feather logo, Apache&nbsp;Isis, and the Apache&nbsp;Isis project logo are all trademarks of The&nbsp;Apache&nbsp;Software&nbsp;Foundation.

+          </p>

+        </footer>

+

+    </div>

+

+    <div id="doc-content-right" class="large-3 medium-3 xcolumns">

+        <div id="toc" class="toc2">

+            <div class="fallback-toc">

+                <ul class="sectlevel1">
+<li><a href="#_using_the_tentacles_tool">Using the Tentacles tool</a></li>
+</ul>

+            </div>

+        </div>

+    </div>

+

+</div>

+

+

+<script src="./js/foundation/5.5.1/vendor/jquery.js"></script>

+<script src="./js/foundation/5.5.1/foundation.min.js"></script>

+

+

+<link href="./css/jquery.tocify/1.9.0/jquery.tocify.css" rel="stylesheet">

+<script src="./js/jqueryui/1.11.4/jquery-ui.min.js"></script> -->

+<script src="./js/jquery.tocify/1.9.0/jquery.tocify.js"></script>

+

+

+

+<script type="text/javascript">

+    $(function () {

+        $("#toc").tocify({

+            scrollTo: 50,

+            extendPage: true,

+            context: "#doc-content",

+            highlightOnScroll: true,

+            hashGenerator: "pretty",

+            hideEffect: "slideUp",

+            selectors: "h2,h3,h4,h5"

+        });

+        $(".fallback-toc").hide();

+    });

+</script>

+

+<script type="text/javascript">

+

+  /****

+

+      $(document).foundation();

+

+      $(document).ready(function(){

+        // Cache selectors

+        var lastId,

+            topMenu = $("div#toc ul"),

+            topMenuHeight = 100,

+

+            menuItems = topMenu.find("a"),

+            menuItemsHrefs = menuItems.map(function(){

+              var item = $($(this).attr("href"));

+              if (item.length) { return item; }

+            });

+

+        // Bind click handler to menu items to scroll animation

+        menuItems.click(function(e){

+          var href = $(this).attr("href"),

+              offsetTop = href === "#" ? 0 : $(href).offset().top-topMenuHeight+1;

+          $('html, body').stop().animate({

+              scrollTop: offsetTop

+          }, 300);

+

+          e.preventDefault();

+        });

+

+        // Bind to scroll of window

+        $(  window ).scroll(function(){

+

+           // Get container scroll position

+           var fromTop = $(this).scrollTop()+topMenuHeight;

+

+           var cur = menuItemsHrefs.map(function(){

+             if ($(this).offset().top < fromTop)

+               return this;

+           });

+

+           // Get the id of the current element

+           cur = cur[cur.length-1];

+

+           var id = cur && cur.length ? cur[0].id : "";

+

+           if (lastId !== id && id) {

+               scrollTo(id);

+           }

+

+           window.history.pushState({}, "", window.location.origin + window.location.pathname + "#" + id);

+        });

+

+        scrollTo = function(id) {

+              lastId = id;

+

+              menuItems

+                .removeClass("active");

+

+              menuItems

+                .parents()

+                .removeClass("active-region");

+

+              menuItems

+                .parents("ul").hide();

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .addClass("active");

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .parents("ul").show();

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .parent().children("ul").show();

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .parents("li").addClass("active-region");

+

+        }

+      menuItems

+        .removeClass("active");

+

+      menuItems

+        .parents()

+        .removeClass("active-region");

+

+        var syncMenuItem;

+        if(window.location.hash!=="") {

+            var menuItemFor = $.grep(menuItems, function(e) {

+                return e.hash === window.location.hash;

+            });

+            console.log(menuItemFor);

+            if(menuItemFor.length === 1) {

+                syncMenuItem = menuItemFor[0];

+            }

+        }

+

+        if(!syncMenuItem){

+            syncMenuItem = menuItems[0];

+        }

+

+        $(syncMenuItem).click();

+

+      });

+

+    ***/

+

+</script>

+

+<script type="text/javascript">

+

+$(document).ready(function(){

+    if("Documentation" === "Verifying Releases using Creadur Tools") {

+        console.log( "processing 'Documentation'" );

+

+        $("#doc-content-left").removeClass("large-9").removeClass("medium-9").addClass("large-12").addClass("medium-12");

+        $("#doc-content-right").removeClass("large-3").removeClass("medium-3").hide();

+    }

+

+});

+

+</script>

+

+

+<script>

+

+$( document ).ready(function() {

+

+    (function() {

+      $(function() {

+        return $("#doc-content h2, #doc-content h3, #doc-content h4, #doc-content h5, #doc-content h6").each(function(i, el) {

+          var $el, icon, id;

+          $el = $(el);

+          id = $el.attr('id');

+          icon = '<i class="fa fa-link"></i>';

+          if (id) {

+            return $el.prepend($("<a />").addClass("header-link").attr("href", "#" + id).html(icon));

+          }

+        });

+      });

+    }).call(this);

+

+

+

+	/*

+        http://osvaldas.info/auto-hide-sticky-header

+        MIT license

+	*/

+	;( function( $, window, document, undefined )

+	{

+		'use strict';

+

+		var elSelector		= '.header',

+			elClassHidden	= 'header--hidden',

+			throttleTimeout	= 500,

+			$element		= $( elSelector );

+

+		if( !$element.length ) return true;

+

+		var $window			= $( window ),

+			wHeight			= 0,

+			wScrollCurrent	= 0,

+			wScrollBefore	= 0,

+			wScrollDiff		= 0,

+			$document		= $( document ),

+			dHeight			= 0,

+

+			throttle = function( delay, fn )

+			{

+				var last, deferTimer;

+				return function()

+				{

+					var context = this, args = arguments, now = +new Date;

+					if( last && now < last + delay )

+					{

+						clearTimeout( deferTimer );

+						deferTimer = setTimeout( function(){ last = now; fn.apply( context, args ); }, delay );

+					}

+					else

+					{

+						last = now;

+						fn.apply( context, args );

+					}

+				};

+			};

+

+		$window.on( 'scroll', throttle( throttleTimeout, function()

+		{

+			dHeight			= $document.height();

+			wHeight			= $window.height();

+			wScrollCurrent	= $window.scrollTop();

+			wScrollDiff		= wScrollBefore - wScrollCurrent;

+

+			if( wScrollCurrent <= 0 ) // scrolled to the very top; element sticks to the top

+				$element.removeClass( elClassHidden );

+

+			else if( wScrollDiff > 0 && $element.hasClass( elClassHidden ) ) // scrolled up; element slides in

+				$element.removeClass( elClassHidden );

+

+			else if( wScrollDiff < 0 ) // scrolled down

+			{

+				if( wScrollCurrent + wHeight >= dHeight && $element.hasClass( elClassHidden ) ) // scrolled to the very bottom; element slides in

+					$element.removeClass( elClassHidden );

+

+				else // scrolled down; element slides out

+					$element.addClass( elClassHidden );

+			}

+

+			wScrollBefore = wScrollCurrent;

+		}));

+

+	})( jQuery, window, document );

+

+

+});

+</script>

+

+</body>

+</html>
\ No newline at end of file

Added: isis/site/trunk/content/verifying-releases.html
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/verifying-releases.html?rev=1685718&view=auto
==============================================================================
--- isis/site/trunk/content/verifying-releases.html (added)
+++ isis/site/trunk/content/verifying-releases.html Tue Jun 16 06:32:10 2015
@@ -0,0 +1,939 @@
+<!doctype html>

+<html class="no-js" lang="en">

+<head>

+    <meta charset="utf-8"/>

+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>

+

+    <title>Verifying Releases</title>

+

+    <!--

+        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.

+    -->

+

+    <!-- No caching headers -->

+    <meta http-equiv="cache-control" content="no-cache" />

+    <meta http-equiv="pragma" content="no-cache" />

+    <meta http-equiv="expires" content="-1" />

+

+

+    <!-- TODO: need to (re)instate CDN in the future (not using for now just so can develop off-line -->

+    <link href="./css/foundation/5.5.1/foundation.css" rel="stylesheet" />

+    <script src="./js/foundation/5.5.1/vendor/modernizr.js"></script>

+    <link href="./css/asciidoctor/colony.css" rel="stylesheet">

+    <link href="./css/font-awesome/4.3.0/css/font-awesome.min.css" rel="stylesheet">

+

+

+

+

+    <link href="./css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.css" rel="stylesheet" />

+    <!--[if lt IE 9]>

+      <link href="./css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.ie.css" rel="stylesheet" />

+    <![endif]-->

+

+

+    <style type="text/css">

+        /* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
+/*pre.CodeRay {background-color:#f7f7f8;}*/
+.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em}
+.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)}
+.CodeRay .line-numbers strong{font-weight: normal}
+table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none}
+table.CodeRay td{vertical-align: top}
+table.CodeRay td.line-numbers{text-align:right}
+table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)}
+table.CodeRay td.code{padding:0 0 0 .5em}
+table.CodeRay td.code>pre{padding:0}
+.CodeRay .debug{color:#fff !important;background:#000080 !important}
+.CodeRay .annotation{color:#007}
+.CodeRay .attribute-name{color:#000080}
+.CodeRay .attribute-value{color:#700}
+.CodeRay .binary{color:#509}
+.CodeRay .comment{color:#998;font-style:italic}
+.CodeRay .char{color:#04d}
+.CodeRay .char .content{color:#04d}
+.CodeRay .char .delimiter{color:#039}
+.CodeRay .class{color:#458;font-weight:bold}
+.CodeRay .complex{color:#a08}
+.CodeRay .constant,.CodeRay .predefined-constant{color:#008080}
+.CodeRay .color{color:#099}
+.CodeRay .class-variable{color:#369}
+.CodeRay .decorator{color:#b0b}
+.CodeRay .definition{color:#099}
+.CodeRay .delimiter{color:#000}
+.CodeRay .doc{color:#970}
+.CodeRay .doctype{color:#34b}
+.CodeRay .doc-string{color:#d42}
+.CodeRay .escape{color:#666}
+.CodeRay .entity{color:#800}
+.CodeRay .error{color:#808}
+.CodeRay .exception{color:inherit}
+.CodeRay .filename{color:#099}
+.CodeRay .function{color:#900;font-weight:bold}
+.CodeRay .global-variable{color:#008080}
+.CodeRay .hex{color:#058}
+.CodeRay .integer,.CodeRay .float{color:#099}
+.CodeRay .include{color:#555}
+.CodeRay .inline{color:#00}
+.CodeRay .inline .inline{background:#ccc}
+.CodeRay .inline .inline .inline{background:#bbb}
+.CodeRay .inline .inline-delimiter{color:#d14}
+.CodeRay .inline-delimiter{color:#d14}
+.CodeRay .important{color:#555;font-weight:bold}
+.CodeRay .interpreted{color:#b2b}
+.CodeRay .instance-variable{color:#008080}
+.CodeRay .label{color:#970}
+.CodeRay .local-variable{color:#963}
+.CodeRay .octal{color:#40e}
+.CodeRay .predefined{color:#369}
+.CodeRay .preprocessor{color:#579}
+.CodeRay .pseudo-class{color:#555}
+.CodeRay .directive{font-weight:bold}
+.CodeRay .type{font-weight:bold}
+.CodeRay .predefined-type{color:inherit}
+.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold}
+.CodeRay .key{color:#808}
+.CodeRay .key .delimiter{color:#606}
+.CodeRay .key .char{color:#80f}
+.CodeRay .value{color:#088}
+.CodeRay .regexp .delimiter{color:#808}
+.CodeRay .regexp .content{color:#808}
+.CodeRay .regexp .modifier{color:#808}
+.CodeRay .regexp .char{color:#d14}
+.CodeRay .regexp .function{color:#404;font-weight:bold}
+.CodeRay .string{color:#d20}
+.CodeRay .string .string .string{background:#ffd0d0}
+.CodeRay .string .content{color:#d14}
+.CodeRay .string .char{color:#d14}
+.CodeRay .string .delimiter{color:#d14}
+.CodeRay .shell{color:#d14}
+.CodeRay .shell .delimiter{color:#d14}
+.CodeRay .symbol{color:#990073}
+.CodeRay .symbol .content{color:#a60}
+.CodeRay .symbol .delimiter{color:#630}
+.CodeRay .tag{color:#008080}
+.CodeRay .tag-special{color:#d70}
+.CodeRay .variable{color:#036}
+.CodeRay .insert{background:#afa}
+.CodeRay .delete{background:#faa}
+.CodeRay .change{color:#aaf;background:#007}
+.CodeRay .head{color:#f8f;background:#505}
+.CodeRay .insert .insert{color:#080}
+.CodeRay .delete .delete{color:#800}
+.CodeRay .change .change{color:#66f}
+.CodeRay .head .head{color:#f4f}

+

+        pre.CodeRay code {

+            background-color: inherit;

+            border-style: none;

+        }

+

+        pre.CodeRay code > span:first-child {

+            margin-left: -5px;

+        }

+

+        .literalblock pre,

+        .listingblock pre:not(.highlight),

+        .listingblock pre[class="highlight"],

+        .listingblock pre[class^="highlight "],

+        .listingblock pre.CodeRay,

+        .listingblock pre.prettyprint {

+            background: rgb(253, 250, 246);

+         }

+        .sidebarblock .literalblock pre,

+        .sidebarblock .listingblock pre:not(.highlight),

+        .sidebarblock .listingblock pre[class="highlight"],

+        .sidebarblock .listingblock pre[class^="highlight "],

+        .sidebarblock .listingblock pre.CodeRay,

+        .sidebarblock .listingblock pre.prettyprint {

+            background: rgb(253, 250, 246);

+         }

+

+    <style>

+

+    <style>

+    .github-fork-ribbon-wrapper.right {

+        position: fixed;

+    }

+    .github-fork-ribbon {

+        background: #090;

+    }

+    .github-fork-ribbon a:hover {

+        background:#0D0;

+        color:#fff;

+        font-size: 1.1em;

+    }

+    </style>

+

+    <style>

+        @media only screen and (min-width: 40.063em) {

+          .top-bar {

+            .contain-to-grid .top-bar {

+                max-width: 80rem;

+            }

+          }

+        }

+        .row {

+            max-width: 80rem;

+        }

+    </style>

+

+    <style>

+        .extended-quote,

+        .extended-quote-first {

+            margin-left: 40px;

+            margin-right: 40px;

+            font-style: italic;

+        }

+        .extended-quote-attribution {

+            text-align: right;

+            margin-right: 100px;

+            color: #10B061;

+        }

+

+        .extended-quote-first:before {

+            content: "\201c";

+            float: left;

+            font-size: 2.75em;

+            font-weight: bold;

+            line-height: 0.6em;

+            margin-left: -0.6em;

+            color: #003b6b;

+            text-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);

+        }

+    </style>

+

+    <style>

+        body {

+          position: relative;

+        }

+

+        *:not(pre) a > code {

+            color: #210DDC;

+        }

+

+        *:not(pre) > code {

+            background-color: inherit;

+            border: none;

+            font-weight: normal;

+        }

+

+        body div#toc li,

+        body div#toc2 li {

+            list-style-type: none;

+        }

+

+        div#doc-content {

+            margin-top: 30px;

+        }

+

+        body div#toc li.active-region:before,

+        body div#toc2 li.active-region:before {

+            content: "\00BB \0020";

+            margin-left: -12px;

+        }

+

+        body div#toc li a.active,

+        body div#toc2 li a.active {

+            color: red;

+        }

+

+        body div#toc.toc,

+        body div#toc.toc2 {

+            position: fixed;

+            left: auto;

+            padding-top: 60px;

+            z-index: auto;

+            background-color: white;

+            border-left-color: #eee;

+            border-left-style: solid;

+            border-right: none;

+            min-height: 2000px;

+        }

+

+    </style>

+

+    <style>

+

+        @media only screen and (min-width: 768px) {

+          #toc.toc2 ul ul { margin-left: -10px; }

+        }

+

+

+        body div#toc .tocify-subheader ul {

+            margin-bottom: 0px;

+        }

+

+        body div#toc .tocify-subheader li {

+            font-size: 14px;

+        }

+        .tocify li.tocify-item, .tocify ul.tocify-item {

+            line-height: 24px;

+        }

+

+        body div#toc li.tocify-item.active:before,

+        body div#toc2 li.tocify-item.active:before {

+            content: "\00BB \0020";

+            margin-left: -12px;

+        }

+

+        body div#toc li.tocify-item.active a,

+        body div#toc2 li.tocify-item.active a {

+            color: red;

+        }

+    </style>

+

+    <style>

+        footer {

+            margin-top: 1000px;

+        }

+    </style>

+

+    <style>

+        /* overriding colony.css stylesheet */

+        .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] {

+           /*padding: 1.25em 1.5625em 1.125em 1.5625em;*/

+           padding: 0.3em 0.6em 0.25em 0.6em;

+        }

+        @media only screen and (min-width: 1280px)

+        #toc.toc2 {

+          /*width: 20em;*/

+          width: 25em;

+        }

+

+        #doc-content a {

+          color: #210DDC;

+        }

+

+        .top-bar h1 {

+            border-bottom: inherit;

+        }

+

+        h2 {

+          margin-top: 80px;

+        }

+        h3 {

+          margin-top: 40px;

+        }

+        h4,h5 {

+          margin-top: 30px;

+        }

+

+        .admonitionblock.tip > table td.content {

+            color: #10B061;

+        }

+        .admonitionblock.note > table td.content {

+            color: #B509AB;

+        }

+        .admonitionblock.important > table td.content {

+            color: #D5810A;

+        }

+

+        .admonitionblock .title {

+            font-size: larger;

+            font-style: italic;

+        }

+

+        .imageblock img {

+            margin-bottom: 10px;

+        }

+    </style>

+

+    <style>

+        /* from http://ben.balter.com/2014/03/13/pages-anchor-links/ */

+        .header-link {

+          position: absolute;

+          left: -0.5em;

+          opacity: 0;

+

+          /*

+          -webkit-transition: opacity 0.2s ease-in-out 0.1s;

+          -moz-transition: opacity 0.2s ease-in-out 0.1s;

+          -ms-transition: opacity 0.2s ease-in-out 0.1s;

+          */

+        }

+

+        h2:hover .header-link,

+        h3:hover .header-link,

+        h4:hover .header-link,

+        h5:hover .header-link,

+        h6:hover .header-link {

+          opacity: 1;

+        }

+    </style>

+

+    <style>

+        .top-bar

+        {

+            -webkit-transition-duration: .5s;

+            transition-duration: .5s;

+

+            -webkit-transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );

+            transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );

+

+            -webkit-transition-property: -webkit-transform;

+            transition-property: transform;

+        }

+

+        /*

+        http://osvaldas.info/auto-hide-sticky-header

+        MIT license

+        */

+        .header--hidden

+        {

+            -webkit-transform: translateY( -100% );

+            -ms-transform: translateY( -100% );

+            transform: translateY( -100% );

+

+            transition-duration: .5s;

+            transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );

+            -webkit-transition-property: -webkit-transform;

+            transition-property: transform;

+        }

+    </style>

+

+    <style>

+        #doc-content a.guide {

+            color: white;

+        }

+    </style>

+

+    <style>

+        .tocify {

+            margin-top: 80px;

+        }

+    </style>

+

+

+</script>

+

+</head>

+<body>

+

+<<div class="github-fork-ribbon-wrapper right" style="position: fixed;">

+    <div class="github-fork-ribbon">

+        <a href="https://github.com/apache/isis/fork">Fork me on GitHub</a>

+    </div>

+</div>

+

+

+<div class="row">

+

+    <div class="fixed contain-to-grid header">

+        <nav class="top-bar" data-topbar role="navigation" style="max-width: 80rem">

+            <ul class="title-area">

+                <li class="name">

+                    <h1>

+                        <a href="/index.html">Apache Isis&trade;</a>

+                    </h1>

+                </li>

+                <!-- Remove the class "menu-icon" to get rid of menu icon. Take out "Menu" to just have icon alone -->

+                <li class="toggle-topbar menu-icon"><a href="#"><span>Menu</span></a></li>

+            </ul>

+

+            <section class="top-bar-section">

+                <ul class="right">

+

+                    <li class="has-form">

+                       <FORM class="searchbox navbar-form navbar-right" id="searchbox_012614087480249044419:dn-q5gtwxya" action="http://www.google.com/cse">

+                        <div class="row collapse">

+                            <input type="hidden" name="cx" value="012614087480249044419:dn-q5gtwxya">

+                            <INPUT type="hidden" name="cof" value="FORID:0">

+                            <INPUT class="form-control" name="q" type="text" placeholder="Search">

+                        </div>

+                    </FORM>

+                     </li>

+

+                </ul>

+

+                <!-- Left Nav Section -->

+                <ul class="left">

+

+                    <li><a href="/documentation.html">Documentation</a></li>

+                    <li><a href="/downloads.html">Downloads</a></li>

+                    <li><a href="/help.html">Help</a></li>

+                    <li><a href="/asf.html">@ASF</a></li>

+

+                </ul>

+

+            </section>

+        </nav>

+    </div>

+</div>

+

+<div class="row">

+

+    <div id="doc-content-left" class="large-9 medium-9 columns">

+

+

+        <div id="doc-content">

+          <div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p><br/><br/></p>
+</div>
+<div class="paragraph">
+<p>Whenever a committer announces a vote on a release on the <a href="../support.html">dev mailing list</a>, it is the responsibility of the project&#8217;s PMC to cast their vote on the release. Anyone else can also vote, but only members of the Apache Isis PMC&#8217;s vote are binding.</p>
+</div>
+<div class="paragraph">
+<p>This page provides some guidance on what a voter is expected to verify before casting their vote.</p>
+</div>
+<div class="paragraph">
+<p>Per this <a href="http://www.apache.org/dev/release.html">ASF documentation</a>, the legal requirements for an ASF release are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a source zip file + corresponding signature (signed by the release manager, which is in the ASF web of trust and in our KEYS file)</p>
+</li>
+<li>
+<p>all source files have the Apache license (this is ensured by the running of the rat plugin prior to release; you could run it on the unzipped source)</p>
+</li>
+<li>
+<p>all dependencies are appropriately licensed; see the <code>DEPENDENCIES</code> file which is automatically generated from the POMs plus the supplemental-models.xml file</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Note that the binaries are <em>not</em> an ASF release, they merely exist on the Maven central repo as a convenience. That said, you might also want to verify the release by pulling the binaries from the Maven staging repository. Details of how to do this are also documented below.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_prerequisites">Prerequisites</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To verify the source ZIP files, you will need to have imported the public keys used for signing Isis releases. These can be downloaded from the root of the Isis source tree.</p>
+</div>
+<div class="paragraph">
+<p>Since the Isis source is mirrored on github.com, you can just use:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="bash">curl http://www.apache.org/dist/isis/KEYS &gt; /tmp/KEYS
+gpg --import /tmp/KEYS</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_verifying_the_source_release_artifacts">Verifying the source release artifacts</h2>
+<div class="sectionbody">
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Note: to automate this next stage, there is also a <a href="/contributors/verifying-releases-script.html">script</a> available; but read what follows first before using the script.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Download both the ZIP and .ASC files from the location specified in the voting email. To verify that the signature is correct, use:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="bash">gpg --verify isis-x.y.z.zip.asc isis-x.y.z.zip</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_building_the_source_release_artifacts">Building the source release artifacts</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Assuming the ZIP file verifies, it should be unpacked, and then the artifact built from source.</p>
+</div>
+<div class="paragraph">
+<p>First, delete all Isis artifacts from your local Maven repo:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="bash">rm -rf ~/.m2/repository/org/apache/isis</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>To build Isis core, first download any dependencies:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>mvn dependency:go-offline</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Check that no Isis artifacts have yet been downloaded, ie there is no <code>~/.m2/org/repository/org/apache/isis</code> directory. If there are, it could indicate that the release being verified incorrectly references previous versions of Isis core.</p>
+</div>
+<div class="paragraph">
+<p>Assuming all is ok, build using the <code>-o</code> offline flag:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>mvn clean install -o</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Confirm that the versions of the Isis artifacts now cached in your local repository are correct.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_verifying_the_binary_release_artifacts_using_the_maven_staging_repository">Verifying the binary release artifacts (using the Maven staging repository)</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you wish, you can verify the binary releases by configuring your local Maven install to point to the Maven Maven staging repository (or repositories) and then using them, eg to run the <a href="../intro/getting-started/simpleapp-archetype.html">simpleapp archetype</a> and running the resultant app.</p>
+</div>
+<div class="paragraph">
+<p>Configuring your local Maven install amounts to updating the <code>~/.m2/settings.xml</code> file:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="xml"><span class="tag">&lt;profiles&gt;</span>
+    <span class="tag">&lt;profile&gt;</span>
+        <span class="tag">&lt;id&gt;</span>verify-isis<span class="tag">&lt;/id&gt;</span>
+        <span class="tag">&lt;repositories&gt;</span>
+            <span class="tag">&lt;repository&gt;</span>
+                <span class="tag">&lt;id&gt;</span>isis-core-staging<span class="tag">&lt;/id&gt;</span>
+                <span class="tag">&lt;name&gt;</span>Isis Core Staging<span class="tag">&lt;/name&gt;</span>
+                <span class="tag">&lt;releases&gt;</span>
+                    <span class="tag">&lt;enabled&gt;</span>true<span class="tag">&lt;/enabled&gt;</span>
+                    <span class="tag">&lt;updatePolicy&gt;</span>always<span class="tag">&lt;/updatePolicy&gt;</span>
+                    <span class="tag">&lt;checksumPolicy&gt;</span>warn<span class="tag">&lt;/checksumPolicy&gt;</span>
+                <span class="tag">&lt;/releases&gt;</span>
+                <span class="tag">&lt;url&gt;</span>http://repository.apache.org/content/repositories/orgapacheisis-10xx<span class="tag">&lt;/url&gt;</span>
+                <span class="tag">&lt;layout&gt;</span>default<span class="tag">&lt;/layout&gt;</span>
+            <span class="tag">&lt;/repository&gt;</span>
+            ...
+        <span class="tag">&lt;/repositories&gt;</span>
+    <span class="tag">&lt;/profile&gt;</span>
+    ...
+<span class="tag">&lt;/profiles&gt;</span>
+<span class="tag">&lt;activeProfiles&gt;</span>
+    <span class="tag">&lt;activeProfile&gt;</span>verify-isis<span class="tag">&lt;/activeProfile&gt;</span>
+    ...
+<span class="tag">&lt;/activeProfiles&gt;</span></code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>where the repository URL is as provided in the VOTE email. If there is more than one repository (as is sometimes the case if multiple components have been released), then repeat the &lt;repository&gt; section for each.</p>
+</div>
+<div class="paragraph">
+<p>Once the vote has completed, the staging repositories will be removed and so you should deactive the profile (comment out the <code>&lt;activeProfile&gt;</code> element). If you forget to deactive the profile, there should be no adverse effects; Maven will just spend unnecessary cycles attempting to hit a non-existent repo.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_using_the_creadur_tools">Using the Creadur Tools</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The <a href="http://creadur.apache.org">Apache Creadur</a> project exists to provide a set of tools to ensure compliance with Apache&#8217;s licensing standards. The main release auditing tool, <a href="http://creadur.apache.org/rat">Apache RAT</a>, is used in the preparation of the release (as documented <a href="release-process.html">here</a>). Creadur&#8217;s remaining tools are to support the verification process.</p>
+</div>
+<div class="paragraph">
+<p>At the time of writing, these additional tools are quite young and haven&#8217;t been formally released; so to use them will take a little bit of work. See <a href="verifying-releases-using-creadur-tools.html">here</a> for more details.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_casting_a_vote">Casting a Vote</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>When you have made the above checks (and any other checks you think may be relevant), cast your vote by replying to the email thread on the mailing list. If you are casting <code>-1</code>, please provide details of the problem(s) you have found.</p>
+</div>
+</div>
+</div>

+        </div>

+

+        <footer>

+          <hr>

+          <p class="small">

+          Copyright &copy; 2010~2015 The Apache&nbsp;Software&nbsp;Foundation, licensed under the Apache&nbsp;License,&nbsp;v2.0.

+          <br/>

+          Apache, the Apache feather logo, Apache&nbsp;Isis, and the Apache&nbsp;Isis project logo are all trademarks of The&nbsp;Apache&nbsp;Software&nbsp;Foundation.

+          </p>

+        </footer>

+

+    </div>

+

+    <div id="doc-content-right" class="large-3 medium-3 xcolumns">

+        <div id="toc" class="toc2">

+            <div class="fallback-toc">

+                <ul class="sectlevel1">
+<li><a href="#_prerequisites">Prerequisites</a></li>
+<li><a href="#_verifying_the_source_release_artifacts">Verifying the source release artifacts</a></li>
+<li><a href="#_building_the_source_release_artifacts">Building the source release artifacts</a></li>
+<li><a href="#_verifying_the_binary_release_artifacts_using_the_maven_staging_repository">Verifying the binary release artifacts (using the Maven staging repository)</a></li>
+<li><a href="#_using_the_creadur_tools">Using the Creadur Tools</a></li>
+<li><a href="#_casting_a_vote">Casting a Vote</a></li>
+</ul>

+            </div>

+        </div>

+    </div>

+

+</div>

+

+

+<script src="./js/foundation/5.5.1/vendor/jquery.js"></script>

+<script src="./js/foundation/5.5.1/foundation.min.js"></script>

+

+

+<link href="./css/jquery.tocify/1.9.0/jquery.tocify.css" rel="stylesheet">

+<script src="./js/jqueryui/1.11.4/jquery-ui.min.js"></script> -->

+<script src="./js/jquery.tocify/1.9.0/jquery.tocify.js"></script>

+

+

+

+<script type="text/javascript">

+    $(function () {

+        $("#toc").tocify({

+            scrollTo: 50,

+            extendPage: true,

+            context: "#doc-content",

+            highlightOnScroll: true,

+            hashGenerator: "pretty",

+            hideEffect: "slideUp",

+            selectors: "h2,h3,h4,h5"

+        });

+        $(".fallback-toc").hide();

+    });

+</script>

+

+<script type="text/javascript">

+

+  /****

+

+      $(document).foundation();

+

+      $(document).ready(function(){

+        // Cache selectors

+        var lastId,

+            topMenu = $("div#toc ul"),

+            topMenuHeight = 100,

+

+            menuItems = topMenu.find("a"),

+            menuItemsHrefs = menuItems.map(function(){

+              var item = $($(this).attr("href"));

+              if (item.length) { return item; }

+            });

+

+        // Bind click handler to menu items to scroll animation

+        menuItems.click(function(e){

+          var href = $(this).attr("href"),

+              offsetTop = href === "#" ? 0 : $(href).offset().top-topMenuHeight+1;

+          $('html, body').stop().animate({

+              scrollTop: offsetTop

+          }, 300);

+

+          e.preventDefault();

+        });

+

+        // Bind to scroll of window

+        $(  window ).scroll(function(){

+

+           // Get container scroll position

+           var fromTop = $(this).scrollTop()+topMenuHeight;

+

+           var cur = menuItemsHrefs.map(function(){

+             if ($(this).offset().top < fromTop)

+               return this;

+           });

+

+           // Get the id of the current element

+           cur = cur[cur.length-1];

+

+           var id = cur && cur.length ? cur[0].id : "";

+

+           if (lastId !== id && id) {

+               scrollTo(id);

+           }

+

+           window.history.pushState({}, "", window.location.origin + window.location.pathname + "#" + id);

+        });

+

+        scrollTo = function(id) {

+              lastId = id;

+

+              menuItems

+                .removeClass("active");

+

+              menuItems

+                .parents()

+                .removeClass("active-region");

+

+              menuItems

+                .parents("ul").hide();

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .addClass("active");

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .parents("ul").show();

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .parent().children("ul").show();

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .parents("li").addClass("active-region");

+

+        }

+      menuItems

+        .removeClass("active");

+

+      menuItems

+        .parents()

+        .removeClass("active-region");

+

+        var syncMenuItem;

+        if(window.location.hash!=="") {

+            var menuItemFor = $.grep(menuItems, function(e) {

+                return e.hash === window.location.hash;

+            });

+            console.log(menuItemFor);

+            if(menuItemFor.length === 1) {

+                syncMenuItem = menuItemFor[0];

+            }

+        }

+

+        if(!syncMenuItem){

+            syncMenuItem = menuItems[0];

+        }

+

+        $(syncMenuItem).click();

+

+      });

+

+    ***/

+

+</script>

+

+<script type="text/javascript">

+

+$(document).ready(function(){

+    if("Documentation" === "Verifying Releases") {

+        console.log( "processing 'Documentation'" );

+

+        $("#doc-content-left").removeClass("large-9").removeClass("medium-9").addClass("large-12").addClass("medium-12");

+        $("#doc-content-right").removeClass("large-3").removeClass("medium-3").hide();

+    }

+

+});

+

+</script>

+

+

+<script>

+

+$( document ).ready(function() {

+

+    (function() {

+      $(function() {

+        return $("#doc-content h2, #doc-content h3, #doc-content h4, #doc-content h5, #doc-content h6").each(function(i, el) {

+          var $el, icon, id;

+          $el = $(el);

+          id = $el.attr('id');

+          icon = '<i class="fa fa-link"></i>';

+          if (id) {

+            return $el.prepend($("<a />").addClass("header-link").attr("href", "#" + id).html(icon));

+          }

+        });

+      });

+    }).call(this);

+

+

+

+	/*

+        http://osvaldas.info/auto-hide-sticky-header

+        MIT license

+	*/

+	;( function( $, window, document, undefined )

+	{

+		'use strict';

+

+		var elSelector		= '.header',

+			elClassHidden	= 'header--hidden',

+			throttleTimeout	= 500,

+			$element		= $( elSelector );

+

+		if( !$element.length ) return true;

+

+		var $window			= $( window ),

+			wHeight			= 0,

+			wScrollCurrent	= 0,

+			wScrollBefore	= 0,

+			wScrollDiff		= 0,

+			$document		= $( document ),

+			dHeight			= 0,

+

+			throttle = function( delay, fn )

+			{

+				var last, deferTimer;

+				return function()

+				{

+					var context = this, args = arguments, now = +new Date;

+					if( last && now < last + delay )

+					{

+						clearTimeout( deferTimer );

+						deferTimer = setTimeout( function(){ last = now; fn.apply( context, args ); }, delay );

+					}

+					else

+					{

+						last = now;

+						fn.apply( context, args );

+					}

+				};

+			};

+

+		$window.on( 'scroll', throttle( throttleTimeout, function()

+		{

+			dHeight			= $document.height();

+			wHeight			= $window.height();

+			wScrollCurrent	= $window.scrollTop();

+			wScrollDiff		= wScrollBefore - wScrollCurrent;

+

+			if( wScrollCurrent <= 0 ) // scrolled to the very top; element sticks to the top

+				$element.removeClass( elClassHidden );

+

+			else if( wScrollDiff > 0 && $element.hasClass( elClassHidden ) ) // scrolled up; element slides in

+				$element.removeClass( elClassHidden );

+

+			else if( wScrollDiff < 0 ) // scrolled down

+			{

+				if( wScrollCurrent + wHeight >= dHeight && $element.hasClass( elClassHidden ) ) // scrolled to the very bottom; element slides in

+					$element.removeClass( elClassHidden );

+

+				else // scrolled down; element slides out

+					$element.addClass( elClassHidden );

+			}

+

+			wScrollBefore = wScrollCurrent;

+		}));

+

+	})( jQuery, window, document );

+

+

+});

+</script>

+

+</body>

+</html>
\ No newline at end of file

Added: isis/site/trunk/content/versioning-policy.html
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/versioning-policy.html?rev=1685718&view=auto
==============================================================================
--- isis/site/trunk/content/versioning-policy.html (added)
+++ isis/site/trunk/content/versioning-policy.html Tue Jun 16 06:32:10 2015
@@ -0,0 +1,805 @@
+<!doctype html>

+<html class="no-js" lang="en">

+<head>

+    <meta charset="utf-8"/>

+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>

+

+    <title>Versioning Policy</title>

+

+    <!--

+        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.

+    -->

+

+    <!-- No caching headers -->

+    <meta http-equiv="cache-control" content="no-cache" />

+    <meta http-equiv="pragma" content="no-cache" />

+    <meta http-equiv="expires" content="-1" />

+

+

+    <!-- TODO: need to (re)instate CDN in the future (not using for now just so can develop off-line -->

+    <link href="./css/foundation/5.5.1/foundation.css" rel="stylesheet" />

+    <script src="./js/foundation/5.5.1/vendor/modernizr.js"></script>

+    <link href="./css/asciidoctor/colony.css" rel="stylesheet">

+    <link href="./css/font-awesome/4.3.0/css/font-awesome.min.css" rel="stylesheet">

+

+

+

+

+    <link href="./css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.css" rel="stylesheet" />

+    <!--[if lt IE 9]>

+      <link href="./css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.ie.css" rel="stylesheet" />

+    <![endif]-->

+

+

+    <style type="text/css">

+        /* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
+/*pre.CodeRay {background-color:#f7f7f8;}*/
+.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em}
+.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)}
+.CodeRay .line-numbers strong{font-weight: normal}
+table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none}
+table.CodeRay td{vertical-align: top}
+table.CodeRay td.line-numbers{text-align:right}
+table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)}
+table.CodeRay td.code{padding:0 0 0 .5em}
+table.CodeRay td.code>pre{padding:0}
+.CodeRay .debug{color:#fff !important;background:#000080 !important}
+.CodeRay .annotation{color:#007}
+.CodeRay .attribute-name{color:#000080}
+.CodeRay .attribute-value{color:#700}
+.CodeRay .binary{color:#509}
+.CodeRay .comment{color:#998;font-style:italic}
+.CodeRay .char{color:#04d}
+.CodeRay .char .content{color:#04d}
+.CodeRay .char .delimiter{color:#039}
+.CodeRay .class{color:#458;font-weight:bold}
+.CodeRay .complex{color:#a08}
+.CodeRay .constant,.CodeRay .predefined-constant{color:#008080}
+.CodeRay .color{color:#099}
+.CodeRay .class-variable{color:#369}
+.CodeRay .decorator{color:#b0b}
+.CodeRay .definition{color:#099}
+.CodeRay .delimiter{color:#000}
+.CodeRay .doc{color:#970}
+.CodeRay .doctype{color:#34b}
+.CodeRay .doc-string{color:#d42}
+.CodeRay .escape{color:#666}
+.CodeRay .entity{color:#800}
+.CodeRay .error{color:#808}
+.CodeRay .exception{color:inherit}
+.CodeRay .filename{color:#099}
+.CodeRay .function{color:#900;font-weight:bold}
+.CodeRay .global-variable{color:#008080}
+.CodeRay .hex{color:#058}
+.CodeRay .integer,.CodeRay .float{color:#099}
+.CodeRay .include{color:#555}
+.CodeRay .inline{color:#00}
+.CodeRay .inline .inline{background:#ccc}
+.CodeRay .inline .inline .inline{background:#bbb}
+.CodeRay .inline .inline-delimiter{color:#d14}
+.CodeRay .inline-delimiter{color:#d14}
+.CodeRay .important{color:#555;font-weight:bold}
+.CodeRay .interpreted{color:#b2b}
+.CodeRay .instance-variable{color:#008080}
+.CodeRay .label{color:#970}
+.CodeRay .local-variable{color:#963}
+.CodeRay .octal{color:#40e}
+.CodeRay .predefined{color:#369}
+.CodeRay .preprocessor{color:#579}
+.CodeRay .pseudo-class{color:#555}
+.CodeRay .directive{font-weight:bold}
+.CodeRay .type{font-weight:bold}
+.CodeRay .predefined-type{color:inherit}
+.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold}
+.CodeRay .key{color:#808}
+.CodeRay .key .delimiter{color:#606}
+.CodeRay .key .char{color:#80f}
+.CodeRay .value{color:#088}
+.CodeRay .regexp .delimiter{color:#808}
+.CodeRay .regexp .content{color:#808}
+.CodeRay .regexp .modifier{color:#808}
+.CodeRay .regexp .char{color:#d14}
+.CodeRay .regexp .function{color:#404;font-weight:bold}
+.CodeRay .string{color:#d20}
+.CodeRay .string .string .string{background:#ffd0d0}
+.CodeRay .string .content{color:#d14}
+.CodeRay .string .char{color:#d14}
+.CodeRay .string .delimiter{color:#d14}
+.CodeRay .shell{color:#d14}
+.CodeRay .shell .delimiter{color:#d14}
+.CodeRay .symbol{color:#990073}
+.CodeRay .symbol .content{color:#a60}
+.CodeRay .symbol .delimiter{color:#630}
+.CodeRay .tag{color:#008080}
+.CodeRay .tag-special{color:#d70}
+.CodeRay .variable{color:#036}
+.CodeRay .insert{background:#afa}
+.CodeRay .delete{background:#faa}
+.CodeRay .change{color:#aaf;background:#007}
+.CodeRay .head{color:#f8f;background:#505}
+.CodeRay .insert .insert{color:#080}
+.CodeRay .delete .delete{color:#800}
+.CodeRay .change .change{color:#66f}
+.CodeRay .head .head{color:#f4f}

+

+        pre.CodeRay code {

+            background-color: inherit;

+            border-style: none;

+        }

+

+        pre.CodeRay code > span:first-child {

+            margin-left: -5px;

+        }

+

+        .literalblock pre,

+        .listingblock pre:not(.highlight),

+        .listingblock pre[class="highlight"],

+        .listingblock pre[class^="highlight "],

+        .listingblock pre.CodeRay,

+        .listingblock pre.prettyprint {

+            background: rgb(253, 250, 246);

+         }

+        .sidebarblock .literalblock pre,

+        .sidebarblock .listingblock pre:not(.highlight),

+        .sidebarblock .listingblock pre[class="highlight"],

+        .sidebarblock .listingblock pre[class^="highlight "],

+        .sidebarblock .listingblock pre.CodeRay,

+        .sidebarblock .listingblock pre.prettyprint {

+            background: rgb(253, 250, 246);

+         }

+

+    <style>

+

+    <style>

+    .github-fork-ribbon-wrapper.right {

+        position: fixed;

+    }

+    .github-fork-ribbon {

+        background: #090;

+    }

+    .github-fork-ribbon a:hover {

+        background:#0D0;

+        color:#fff;

+        font-size: 1.1em;

+    }

+    </style>

+

+    <style>

+        @media only screen and (min-width: 40.063em) {

+          .top-bar {

+            .contain-to-grid .top-bar {

+                max-width: 80rem;

+            }

+          }

+        }

+        .row {

+            max-width: 80rem;

+        }

+    </style>

+

+    <style>

+        .extended-quote,

+        .extended-quote-first {

+            margin-left: 40px;

+            margin-right: 40px;

+            font-style: italic;

+        }

+        .extended-quote-attribution {

+            text-align: right;

+            margin-right: 100px;

+            color: #10B061;

+        }

+

+        .extended-quote-first:before {

+            content: "\201c";

+            float: left;

+            font-size: 2.75em;

+            font-weight: bold;

+            line-height: 0.6em;

+            margin-left: -0.6em;

+            color: #003b6b;

+            text-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);

+        }

+    </style>

+

+    <style>

+        body {

+          position: relative;

+        }

+

+        *:not(pre) a > code {

+            color: #210DDC;

+        }

+

+        *:not(pre) > code {

+            background-color: inherit;

+            border: none;

+            font-weight: normal;

+        }

+

+        body div#toc li,

+        body div#toc2 li {

+            list-style-type: none;

+        }

+

+        div#doc-content {

+            margin-top: 30px;

+        }

+

+        body div#toc li.active-region:before,

+        body div#toc2 li.active-region:before {

+            content: "\00BB \0020";

+            margin-left: -12px;

+        }

+

+        body div#toc li a.active,

+        body div#toc2 li a.active {

+            color: red;

+        }

+

+        body div#toc.toc,

+        body div#toc.toc2 {

+            position: fixed;

+            left: auto;

+            padding-top: 60px;

+            z-index: auto;

+            background-color: white;

+            border-left-color: #eee;

+            border-left-style: solid;

+            border-right: none;

+            min-height: 2000px;

+        }

+

+    </style>

+

+    <style>

+

+        @media only screen and (min-width: 768px) {

+          #toc.toc2 ul ul { margin-left: -10px; }

+        }

+

+

+        body div#toc .tocify-subheader ul {

+            margin-bottom: 0px;

+        }

+

+        body div#toc .tocify-subheader li {

+            font-size: 14px;

+        }

+        .tocify li.tocify-item, .tocify ul.tocify-item {

+            line-height: 24px;

+        }

+

+        body div#toc li.tocify-item.active:before,

+        body div#toc2 li.tocify-item.active:before {

+            content: "\00BB \0020";

+            margin-left: -12px;

+        }

+

+        body div#toc li.tocify-item.active a,

+        body div#toc2 li.tocify-item.active a {

+            color: red;

+        }

+    </style>

+

+    <style>

+        footer {

+            margin-top: 1000px;

+        }

+    </style>

+

+    <style>

+        /* overriding colony.css stylesheet */

+        .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] {

+           /*padding: 1.25em 1.5625em 1.125em 1.5625em;*/

+           padding: 0.3em 0.6em 0.25em 0.6em;

+        }

+        @media only screen and (min-width: 1280px)

+        #toc.toc2 {

+          /*width: 20em;*/

+          width: 25em;

+        }

+

+        #doc-content a {

+          color: #210DDC;

+        }

+

+        .top-bar h1 {

+            border-bottom: inherit;

+        }

+

+        h2 {

+          margin-top: 80px;

+        }

+        h3 {

+          margin-top: 40px;

+        }

+        h4,h5 {

+          margin-top: 30px;

+        }

+

+        .admonitionblock.tip > table td.content {

+            color: #10B061;

+        }

+        .admonitionblock.note > table td.content {

+            color: #B509AB;

+        }

+        .admonitionblock.important > table td.content {

+            color: #D5810A;

+        }

+

+        .admonitionblock .title {

+            font-size: larger;

+            font-style: italic;

+        }

+

+        .imageblock img {

+            margin-bottom: 10px;

+        }

+    </style>

+

+    <style>

+        /* from http://ben.balter.com/2014/03/13/pages-anchor-links/ */

+        .header-link {

+          position: absolute;

+          left: -0.5em;

+          opacity: 0;

+

+          /*

+          -webkit-transition: opacity 0.2s ease-in-out 0.1s;

+          -moz-transition: opacity 0.2s ease-in-out 0.1s;

+          -ms-transition: opacity 0.2s ease-in-out 0.1s;

+          */

+        }

+

+        h2:hover .header-link,

+        h3:hover .header-link,

+        h4:hover .header-link,

+        h5:hover .header-link,

+        h6:hover .header-link {

+          opacity: 1;

+        }

+    </style>

+

+    <style>

+        .top-bar

+        {

+            -webkit-transition-duration: .5s;

+            transition-duration: .5s;

+

+            -webkit-transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );

+            transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );

+

+            -webkit-transition-property: -webkit-transform;

+            transition-property: transform;

+        }

+

+        /*

+        http://osvaldas.info/auto-hide-sticky-header

+        MIT license

+        */

+        .header--hidden

+        {

+            -webkit-transform: translateY( -100% );

+            -ms-transform: translateY( -100% );

+            transform: translateY( -100% );

+

+            transition-duration: .5s;

+            transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );

+            -webkit-transition-property: -webkit-transform;

+            transition-property: transform;

+        }

+    </style>

+

+    <style>

+        #doc-content a.guide {

+            color: white;

+        }

+    </style>

+

+    <style>

+        .tocify {

+            margin-top: 80px;

+        }

+    </style>

+

+

+</script>

+

+</head>

+<body>

+

+<<div class="github-fork-ribbon-wrapper right" style="position: fixed;">

+    <div class="github-fork-ribbon">

+        <a href="https://github.com/apache/isis/fork">Fork me on GitHub</a>

+    </div>

+</div>

+

+

+<div class="row">

+

+    <div class="fixed contain-to-grid header">

+        <nav class="top-bar" data-topbar role="navigation" style="max-width: 80rem">

+            <ul class="title-area">

+                <li class="name">

+                    <h1>

+                        <a href="/index.html">Apache Isis&trade;</a>

+                    </h1>

+                </li>

+                <!-- Remove the class "menu-icon" to get rid of menu icon. Take out "Menu" to just have icon alone -->

+                <li class="toggle-topbar menu-icon"><a href="#"><span>Menu</span></a></li>

+            </ul>

+

+            <section class="top-bar-section">

+                <ul class="right">

+

+                    <li class="has-form">

+                       <FORM class="searchbox navbar-form navbar-right" id="searchbox_012614087480249044419:dn-q5gtwxya" action="http://www.google.com/cse">

+                        <div class="row collapse">

+                            <input type="hidden" name="cx" value="012614087480249044419:dn-q5gtwxya">

+                            <INPUT type="hidden" name="cof" value="FORID:0">

+                            <INPUT class="form-control" name="q" type="text" placeholder="Search">

+                        </div>

+                    </FORM>

+                     </li>

+

+                </ul>

+

+                <!-- Left Nav Section -->

+                <ul class="left">

+

+                    <li><a href="/documentation.html">Documentation</a></li>

+                    <li><a href="/downloads.html">Downloads</a></li>

+                    <li><a href="/help.html">Help</a></li>

+                    <li><a href="/asf.html">@ASF</a></li>

+

+                </ul>

+

+            </section>

+        </nav>

+    </div>

+</div>

+

+<div class="row">

+

+    <div id="doc-content-left" class="large-9 medium-9 columns">

+

+

+        <div id="doc-content">

+          <div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p><br/><br/></p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_semantic_versioning">Semantic Versioning</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Starting from v1.0.0, Isis has adopted <a href="http://semver.org">semantic versioning</a> for its versioning policy.</p>
+</div>
+<div class="paragraph">
+<p>Version numbers are in the form <code>x.y.z</code>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>x is bumped up whenever there a breaking API change</p>
+</li>
+<li>
+<p>y is bumped up whenever there is a new feature that does not break API</p>
+</li>
+<li>
+<p>z is bumped up for minor bug fixes.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>This scheme would be adopted for both core and components.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_version_numbers_may_not_be_used">Version numbers may not be used</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Version ranges may not be used.  If necessary, end-users can use <code>&lt;dependencyManagement</code> elements to have combine components built against different versions of core.</p>
+</div>
+<div class="paragraph">
+<p>That said, this can introduce instability and so generally we recommend that end-users configure the <code>maven-enforcer-plugin</code> and its <a href="http://maven.apache.org/enforcer/enforcer-rules/dependencyConvergence.html">DependencyConvergence</a> rule.  This will help avoid "jar hell" (components having conflicting dependencies of core).</p>
+</div>
+<div class="paragraph">
+<p>If there is a conflict, we would ask that end-users engage with Isis committers to have an updated version of the component(s) pushed out.</p>
+</div>
+</div>
+</div>

+        </div>

+

+        <footer>

+          <hr>

+          <p class="small">

+          Copyright &copy; 2010~2015 The Apache&nbsp;Software&nbsp;Foundation, licensed under the Apache&nbsp;License,&nbsp;v2.0.

+          <br/>

+          Apache, the Apache feather logo, Apache&nbsp;Isis, and the Apache&nbsp;Isis project logo are all trademarks of The&nbsp;Apache&nbsp;Software&nbsp;Foundation.

+          </p>

+        </footer>

+

+    </div>

+

+    <div id="doc-content-right" class="large-3 medium-3 xcolumns">

+        <div id="toc" class="toc2">

+            <div class="fallback-toc">

+                <ul class="sectlevel1">
+<li><a href="#_semantic_versioning">Semantic Versioning</a></li>
+<li><a href="#_version_numbers_may_not_be_used">Version numbers may not be used</a></li>
+</ul>

+            </div>

+        </div>

+    </div>

+

+</div>

+

+

+<script src="./js/foundation/5.5.1/vendor/jquery.js"></script>

+<script src="./js/foundation/5.5.1/foundation.min.js"></script>

+

+

+<link href="./css/jquery.tocify/1.9.0/jquery.tocify.css" rel="stylesheet">

+<script src="./js/jqueryui/1.11.4/jquery-ui.min.js"></script> -->

+<script src="./js/jquery.tocify/1.9.0/jquery.tocify.js"></script>

+

+

+

+<script type="text/javascript">

+    $(function () {

+        $("#toc").tocify({

+            scrollTo: 50,

+            extendPage: true,

+            context: "#doc-content",

+            highlightOnScroll: true,

+            hashGenerator: "pretty",

+            hideEffect: "slideUp",

+            selectors: "h2,h3,h4,h5"

+        });

+        $(".fallback-toc").hide();

+    });

+</script>

+

+<script type="text/javascript">

+

+  /****

+

+      $(document).foundation();

+

+      $(document).ready(function(){

+        // Cache selectors

+        var lastId,

+            topMenu = $("div#toc ul"),

+            topMenuHeight = 100,

+

+            menuItems = topMenu.find("a"),

+            menuItemsHrefs = menuItems.map(function(){

+              var item = $($(this).attr("href"));

+              if (item.length) { return item; }

+            });

+

+        // Bind click handler to menu items to scroll animation

+        menuItems.click(function(e){

+          var href = $(this).attr("href"),

+              offsetTop = href === "#" ? 0 : $(href).offset().top-topMenuHeight+1;

+          $('html, body').stop().animate({

+              scrollTop: offsetTop

+          }, 300);

+

+          e.preventDefault();

+        });

+

+        // Bind to scroll of window

+        $(  window ).scroll(function(){

+

+           // Get container scroll position

+           var fromTop = $(this).scrollTop()+topMenuHeight;

+

+           var cur = menuItemsHrefs.map(function(){

+             if ($(this).offset().top < fromTop)

+               return this;

+           });

+

+           // Get the id of the current element

+           cur = cur[cur.length-1];

+

+           var id = cur && cur.length ? cur[0].id : "";

+

+           if (lastId !== id && id) {

+               scrollTo(id);

+           }

+

+           window.history.pushState({}, "", window.location.origin + window.location.pathname + "#" + id);

+        });

+

+        scrollTo = function(id) {

+              lastId = id;

+

+              menuItems

+                .removeClass("active");

+

+              menuItems

+                .parents()

+                .removeClass("active-region");

+

+              menuItems

+                .parents("ul").hide();

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .addClass("active");

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .parents("ul").show();

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .parent().children("ul").show();

+

+              menuItems

+                .filter("[href=#"+id+"]")

+                .parents("li").addClass("active-region");

+

+        }

+      menuItems

+        .removeClass("active");

+

+      menuItems

+        .parents()

+        .removeClass("active-region");

+

+        var syncMenuItem;

+        if(window.location.hash!=="") {

+            var menuItemFor = $.grep(menuItems, function(e) {

+                return e.hash === window.location.hash;

+            });

+            console.log(menuItemFor);

+            if(menuItemFor.length === 1) {

+                syncMenuItem = menuItemFor[0];

+            }

+        }

+

+        if(!syncMenuItem){

+            syncMenuItem = menuItems[0];

+        }

+

+        $(syncMenuItem).click();

+

+      });

+

+    ***/

+

+</script>

+

+<script type="text/javascript">

+

+$(document).ready(function(){

+    if("Documentation" === "Versioning Policy") {

+        console.log( "processing 'Documentation'" );

+

+        $("#doc-content-left").removeClass("large-9").removeClass("medium-9").addClass("large-12").addClass("medium-12");

+        $("#doc-content-right").removeClass("large-3").removeClass("medium-3").hide();

+    }

+

+});

+

+</script>

+

+

+<script>

+

+$( document ).ready(function() {

+

+    (function() {

+      $(function() {

+        return $("#doc-content h2, #doc-content h3, #doc-content h4, #doc-content h5, #doc-content h6").each(function(i, el) {

+          var $el, icon, id;

+          $el = $(el);

+          id = $el.attr('id');

+          icon = '<i class="fa fa-link"></i>';

+          if (id) {

+            return $el.prepend($("<a />").addClass("header-link").attr("href", "#" + id).html(icon));

+          }

+        });

+      });

+    }).call(this);

+

+

+

+	/*

+        http://osvaldas.info/auto-hide-sticky-header

+        MIT license

+	*/

+	;( function( $, window, document, undefined )

+	{

+		'use strict';

+

+		var elSelector		= '.header',

+			elClassHidden	= 'header--hidden',

+			throttleTimeout	= 500,

+			$element		= $( elSelector );

+

+		if( !$element.length ) return true;

+

+		var $window			= $( window ),

+			wHeight			= 0,

+			wScrollCurrent	= 0,

+			wScrollBefore	= 0,

+			wScrollDiff		= 0,

+			$document		= $( document ),

+			dHeight			= 0,

+

+			throttle = function( delay, fn )

+			{

+				var last, deferTimer;

+				return function()

+				{

+					var context = this, args = arguments, now = +new Date;

+					if( last && now < last + delay )

+					{

+						clearTimeout( deferTimer );

+						deferTimer = setTimeout( function(){ last = now; fn.apply( context, args ); }, delay );

+					}

+					else

+					{

+						last = now;

+						fn.apply( context, args );

+					}

+				};

+			};

+

+		$window.on( 'scroll', throttle( throttleTimeout, function()

+		{

+			dHeight			= $document.height();

+			wHeight			= $window.height();

+			wScrollCurrent	= $window.scrollTop();

+			wScrollDiff		= wScrollBefore - wScrollCurrent;

+

+			if( wScrollCurrent <= 0 ) // scrolled to the very top; element sticks to the top

+				$element.removeClass( elClassHidden );

+

+			else if( wScrollDiff > 0 && $element.hasClass( elClassHidden ) ) // scrolled up; element slides in

+				$element.removeClass( elClassHidden );

+

+			else if( wScrollDiff < 0 ) // scrolled down

+			{

+				if( wScrollCurrent + wHeight >= dHeight && $element.hasClass( elClassHidden ) ) // scrolled to the very bottom; element slides in

+					$element.removeClass( elClassHidden );

+

+				else // scrolled down; element slides out

+					$element.addClass( elClassHidden );

+			}

+

+			wScrollBefore = wScrollCurrent;

+		}));

+

+	})( jQuery, window, document );

+

+

+});

+</script>

+

+</body>

+</html>
\ No newline at end of file