You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by bu...@apache.org on 2015/04/16 09:54:59 UTC

svn commit: r947854 [7/7] - in /websites/staging/isis/trunk: cgi-bin/ content/ content/docs/ content/docs/css/github-fork-ribbon-css/ content/docs/css/github-fork-ribbon-css/0.1.1/ content/docs/getting-started/archetype/ content/docs/getting-started/de...

Modified: websites/staging/isis/trunk/content/docs/user-guide/user-guide.html
==============================================================================
--- websites/staging/isis/trunk/content/docs/user-guide/user-guide.html (original)
+++ websites/staging/isis/trunk/content/docs/user-guide/user-guide.html Thu Apr 16 07:54:58 2015
@@ -62,131 +62,155 @@
 
 
 
-    <link rel="stylesheet" href="../css/foundation/5.5.1/foundation.css"/>
+    <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/foundation-potion.css" rel="stylesheet">
+    <link href="../css/asciidoctor/colony.css" rel="stylesheet">
 
     <link href="../css/font-awesome/4.3.0/css/font-awesome.min.css" rel="stylesheet">
 
 
 
-    <style type="text/css">
-
-        #forkongithub a{
-
-            display: none;
-
-            background:#090;
-
-            color:#fff;
-
-            text-decoration:none;
-
-            font-family:arial, sans-serif;
+    <link href="../css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.css" rel="stylesheet" />
 
-            text-align:center;
+    <!--[if lt IE 9]>
 
-            font-weight:bold;
+      <link href="../css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.ie.css" rel="stylesheet" />
 
-            padding:5px 40px;
-
-            font-size:1rem;
-
-            line-height:2rem;
-
-            position:relative;
-
-            transition:0.5s;
-
-        }
+    <![endif]-->
 
-        #forkongithub a:hover{
 
-            background:#0D0;
 
-            color:#fff;
-
-        }
-
-        #forkongithub a::before,
-
-        #forkongithub a::after{
-
-            content:"";width:100%;
-
-            display:block;
-
-            position:fixed;
-
-            top:1px;
-
-            left:0;
-
-            height:1px;
+    <style type="text/css">
 
-            background:#fff;
+        /* 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}
 
-            z-index: 9999;
 
-        }
 
-        #forkongithub a::after{
+        pre.CodeRay code {
 
-            bottom:1px;
+            background-color: inherit;
 
-            top:auto;
+            border-style: none;
 
         }
 
-        @media screen and (min-width:768px){
-
-            #forkongithub{
-
-                position:fixed;
-
-                display:block;
-
-                top:0;
-
-                right:0;
-
-                width:250px;
-
-                overflow:hidden;
-
-                height:250px;
-
-                z-index: 9999;
+    <style>
 
-            }
 
-            #forkongithub a{
 
-                display:inherit;
+    <style>
 
-                width:250px;
+    .github-fork-ribbon-wrapper.right {
 
-                position:fixed;
+        position: fixed;
 
-                font-size:small;
+    }
 
-                top:40px;
+    .github-fork-ribbon {
 
-                right:-60px;
+        background: #090;
 
-                transform:rotate(45deg);
+    }
 
-                -webkit-transform:rotate(45deg);
+    .github-fork-ribbon a:hover {
 
-                -ms-transform:rotate(45deg);
+        background:#0D0;
 
-                box-shadow:4px 4px 10px rgba(0,0,0,0.8);
+        color:#fff;
 
-            }
+        font-size: 1.1em;
 
-        }
+    }
 
     </style>
 
@@ -250,7 +274,7 @@
 
             left: auto;
 
-            padding-top: 120px;
+            padding-top: 80px;
 
             z-index: auto;
 
@@ -270,17 +294,33 @@
 
 
 
+    <style>
+
+        footer {
+
+            margin-top: 1000px;
+
+        }
+
+    </style>
+
+
+
 </head>
 
 <body>
 
 
 
-    <span id="forkongithub">
+<div class="github-fork-ribbon-wrapper right" style="position: fixed;">
 
-        <a href="https://github.com/apache/isis">Fork me on GitHub</a>
+    <div class="github-fork-ribbon">
 
-    </span>
+        <a href="https://github.com/apache/isis/fork">Fork me on GitHub</a>
+
+    </div>
+
+</div>
 
 
 
@@ -487,11 +527,11 @@
           <div class="sect1">
 <h2 id="_core_concepts">1. Core Concepts</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -501,11 +541,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_principles">1.1. Principles</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -522,13 +562,20 @@ TODO
 </div>
 <div class="sect3">
 <h4 id="_naked_objects_pattern">1.1.2. Naked Objects Pattern</h4>
-<div class="exampleblock">
-<div class="title">Example 1. Object Interface Mapping</div>
-<div class="content">
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+<div class="title">Object Interface Mapping</div>
 <div class="paragraph">
 <p>Just as an ORM (such as <a href="http://datanucleus.org">DataNucleus</a> or <a href="http:hibernate.org">Hibernate</a>) maps domain entities to a database, you can think of Naked Objects as an OIM - mapping domain objects to a user interface.</p>
 </div>
-</div>
+</td>
+</tr>
+</table>
 </div>
 <div class="ulist">
 <ul>
@@ -540,15 +587,18 @@ TODO
 </div>
 <div class="sect3">
 <h4 id="_hexagonal_architecture">1.1.3. Hexagonal Architecture</h4>
-<div class="admonitionblock note">
+<div class="paragraph">
+<p>Originally described by Alistair Cockburn, the <a href="http://alistair.cockburn.us/Hexagonal+architecture">Hexagonal Architecture</a> &#8230;&#8203;</p>
+</div>
+<div class="admonitionblock tip">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-tip" title="Tip"></i>
 </td>
 <td class="content">
 <div class="paragraph">
-<p>The hexagonal architecture is also known as the ports-and-adapters architecture.  another name used (less frequently) is the onion architecture.</p>
+<p>The hexagonal architecture is also known as the <a href="http://c2.com/cgi/wiki?PortsAndAdaptersArchitecture:">Ports and Adapters</a> architecture or (less frequently) as the <a href="http://jeffreypalermo.com/blog/the-onion-architecture-part-1/">Onion</a> architecture.</p>
 </div>
 </td>
 </tr>
@@ -623,11 +673,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_apache_isis_vs">1.2. Apache Isis vs &#8230;&#8203;</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -654,11 +704,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_building_blocks">1.3. Building Blocks</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -981,11 +1031,11 @@ public interface EmailService {
 </div>
 <div class="sect3">
 <h4 id="_framework_provided_services">1.3.9. Framework-provided Services</h4>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1122,11 +1172,11 @@ TODO
 <div class="sect1">
 <h2 id="_how_tos">2. How-tos</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1135,12 +1185,12 @@ TODO
 </table>
 </div>
 <div class="sect2">
-<h3 id="_class_members">2.1. Class Members</h3>
-<div class="admonitionblock note">
+<h3 id="_class_structure">2.1. Class Structure</h3>
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1266,24 +1316,45 @@ TODO
 </div>
 <div class="sect3">
 <h4 id="_collection">2.1.3. Collection</h4>
-<div class="listingblock">
-<div class="content">
-<pre>While Isis support collections of references, the framework (currently) does not support collections of values. That is, it isn't possible to define a collection of type `Set&lt;String&gt;`.
-
-Or, actually, you can, because that is a valid mapping supported by JDO/DataNucleus .  However, Isis has no default visualization.
-
-The workaround is to mark the collection as `@Programmatic`, as described in &lt;&lt;Ignoring Methods&gt;&gt;.  This ensures that the collection is ignored by Isis.</pre>
+<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>While Isis support collections of references, the framework (currently) does not support collections of values. That is, it isn&#8217;t possible to define a collection of type <code>Set&lt;String&gt;</code>.</p>
+</div>
+<div class="paragraph">
+<p>Or, actually, you can, because that is a valid mapping supported by JDO/DataNucleus .  However, Isis has no default visualization.</p>
+</div>
+<div class="paragraph">
+<p>The workaround is to mark the collection as <code>@Programmatic</code>, as described in <a href="#_ignoring_methods">Ignoring Methods</a>.  This ensures that the collection is ignored by Isis.</p>
 </div>
+</td>
+</tr>
+</table>
 </div>
 </div>
 <div class="sect3">
 <h4 id="_actions">2.1.4. Actions</h4>
-<div class="listingblock">
-<div class="content">
-<pre>While Isis support actions whose parameters' types are scalar (values such as `String`, `int`, or references such as `Customer`), the framework (currently) does not support parameter types that are collections or maps.
-
-The workaround is to mark the collection as `@Programmatic`, as described in &lt;&lt;Ignoring Methods&gt;&gt;.  This ensures that the collection is ignored by Isis.</pre>
+<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>While Isis support actions whose parameters' types are scalar (values such as <code>String</code>, <code>int</code>, or references such as <code>Customer</code>), the framework (currently) does not support parameter types that are collections or maps.</p>
+</div>
+<div class="paragraph">
+<p>The workaround is to mark the collection as <code>@Programmatic</code>, as described in <a href="#_ignoring_methods">Ignoring Methods</a>.  This ensures that the collection is ignored by Isis.</p>
 </div>
+</td>
+</tr>
+</table>
 </div>
 <div class="sect4">
 <h5 id="_optional_action_argument">Optional Action Argument</h5>
@@ -1355,11 +1426,11 @@ The workaround is to mark the collection
 </div>
 <div class="sect2">
 <h3 id="_entity_relationships">2.2. Entity Relationships</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1378,11 +1449,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_contributed_members">2.3. Contributed Members</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1405,11 +1476,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_derived_members">2.4. Derived Members</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1456,11 +1527,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_object_management_crud">2.5. Object Management (CRUD)</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1487,11 +1558,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_ui_hints">2.6. UI Hints</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1586,11 +1657,11 @@ isis.reflector.facet.cssClass.patterns=\
 </div>
 <div class="sect2">
 <h3 id="_business_rules">2.7. Business Rules</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1685,11 +1756,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_business_rules_2">2.8. Business Rules</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1745,11 +1816,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_triggering_events">2.9. Triggering Events</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -1936,11 +2007,11 @@ methods for properties (see ?).</p>
 </div>
 <div class="sect2">
 <h3 id="_tips_n_tricks">2.10. Tips n Tricks</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2057,11 +2128,11 @@ used by the supporting <code>validateXxx
 </div>
 <div class="sect2">
 <h3 id="_error_handling">2.11. Error Handling</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2080,11 +2151,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_i18n">2.12. i18n</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2095,11 +2166,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_multi_tenancy">2.13. Multi-tenancy</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2110,11 +2181,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_persistence_lifecycle">2.14. Persistence Lifecycle</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2128,11 +2199,11 @@ TODO
 <div class="sect1">
 <h2 id="_reference">3. Reference</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2142,11 +2213,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_recognized_methods">3.1. Recognized Methods</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2157,11 +2228,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_recognized_annotations">3.2. Recognized Annotations</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2172,11 +2243,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_domain_services_2">3.3. Domain Services</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2187,11 +2258,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_value_types">3.4. Value Types</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2218,11 +2289,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_applib_utility_classes_2">3.6. Applib Utility Classes</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2233,11 +2304,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_convenience_superclasses">3.7. Convenience Superclasses</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2251,11 +2322,11 @@ TODO
 <div class="sect1">
 <h2 id="_testing">4. Testing</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2296,11 +2367,11 @@ TODO
 <div class="sect1">
 <h2 id="_wicket_viewer">5. Wicket Viewer</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2427,11 +2498,11 @@ TODO
 <div class="sect1">
 <h2 id="_restful_viewer">6. Restful Viewer</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2487,11 +2558,11 @@ TODO
 <div class="sect1">
 <h2 id="_configuration_and_deployment">7. Configuration and Deployment</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2637,11 +2708,11 @@ TODO
 <div class="sect1">
 <h2 id="_isis_addons_not_asf">8. Isis Addons (not ASF)</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2761,11 +2832,11 @@ Note that Isis addons, while maintained
 <div class="sect1">
 <h2 id="_integrating_with_other_systems">9. Integrating with Other Systems</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2784,11 +2855,11 @@ TODO
 <div class="sect1">
 <h2 id="_extending">10. Extending</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2802,11 +2873,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_programming_model">10.2. Programming Model</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2862,11 +2933,11 @@ TODO
 <div class="sect1">
 <h2 id="_trouble_shooting">11. Trouble Shooting</h2>
 <div class="sectionbody">
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2880,11 +2951,11 @@ TODO
 </div>
 <div class="sect2">
 <h3 id="_trouble_shooting_datanucleus_logging">11.2. Trouble Shooting: DataNucleus Logging</h3>
-<div class="admonitionblock note">
+<div class="admonitionblock important">
 <table>
 <tr>
 <td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
 TODO
@@ -2900,10 +2971,10 @@ TODO
 
 
 
-        <hr>
-
         <footer>
 
+          <hr>
+
           <p class="small">
 
           Copyright &copy; 2010~2015 The Apache&nbsp;Software&nbsp;Foundation, licensed under the Apache&nbsp;License,&nbsp;v2.0.
@@ -2926,7 +2997,7 @@ TODO
 
         <!-- the 'hide' class is removed by Javascript -->
 
-        <div id="toc" class="toc2 hide">
+        <div id="toc" class="toc2">
 
           <ul class="sectlevel1">
 <li><a href="#_core_concepts">1. Core Concepts</a>
@@ -2973,7 +3044,12 @@ TODO
 <li><a href="#__suppressing_contributed_actions">(Suppressing) contributed actions</a></li>
 <li><a href="#__suppressing_service_menu_items">(Suppressing) service menu items</a></li>
 <li><a href="#__suppressing_service_menus">(Suppressing) service menus</a></li>
-<li><a href="#_initializing_services">Initializing Services</a></li>
+<li><a href="#_initializing_services">Initializing Services</a>
+<ul class="sectlevel5">
+<li><a href="#_initialization">Initialization</a></li>
+<li><a href="#_shutdown">Shutdown</a></li>
+</ul>
+</li>
 <li><a href="#_the_getid_method">The getId() method</a></li>
 </ul>
 </li>
@@ -2981,7 +3057,45 @@ TODO
 <ul class="sectlevel4">
 <li><a href="#_api_vs_spi">API vs SPI</a></li>
 <li><a href="#_autoregistration_of_domain_services">Autoregistration of Domain services</a></li>
-<li><a href="#_overview_of_domain_services">Overview of Domain Services</a></li>
+<li><a href="#_overview_of_domain_services">Overview of Domain Services</a>
+<ul class="sectlevel5">
+<li><a href="#__code_domainobjectcontainer_code"><code>DomainObjectContainer</code></a></li>
+<li><a href="#__code_clockservice_code"><code>ClockService</code></a></li>
+<li><a href="#__code_isissupportjdo_code"><code>IsisSupportJdo</code></a></li>
+<li><a href="#__code_exceptionrecognizer_code"><code>ExceptionRecognizer</code></a></li>
+<li><a href="#__code_wrapperfactory_code"><code>WrapperFactory</code></a></li>
+<li><a href="#__code_eventbusservice_code"><code>EventBusService</code></a></li>
+<li><a href="#_commands_background">Commands/Background</a>
+<ul class="sectlevel6">
+<li><a href="#__code_commandcontext_code"><code>CommandContext</code></a></li>
+<li><a href="#__code_backgroundservice_code"><code>BackgroundService</code></a></li>
+</ul>
+</li>
+<li><a href="#_information_sharing">Information Sharing</a>
+<ul class="sectlevel6">
+<li><a href="#__code_scratchpad_code"><code>ScratchPad</code></a></li>
+<li><a href="#__code_actioninvocationcontext_code"><code>ActionInvocationContext</code></a></li>
+<li><a href="#__code_queryresultscache_code"><code>QueryResultsCache</code></a></li>
+</ul>
+</li>
+<li><a href="#__code_emailservice_code"><code>EmailService</code></a></li>
+<li><a href="#_usermanagement">UserManagement</a>
+<ul class="sectlevel6">
+<li><a href="#__code_userprofileservice_code_spi"><code>UserProfileService</code> (SPI)</a></li>
+<li><a href="#__code_userregistrationservice_code_spi"><code>UserRegistrationService</code> (SPI)</a></li>
+<li><a href="#__code_emailnotificationservice_code"><code>EmailNotificationService</code></a></li>
+</ul>
+</li>
+<li><a href="#_bookmarks_and_mementos">Bookmarks and Mementos</a>
+<ul class="sectlevel6">
+<li><a href="#__code_bookmarkservice_code"><code>BookmarkService</code></a></li>
+<li><a href="#__code_mementoservice_code"><code>MementoService</code></a></li>
+<li><a href="#__code_deeplinkservice_code"><code>DeepLinkService</code></a></li>
+<li><a href="#__code_xmlsnapshotservice_code"><code>XmlSnapshotService</code></a></li>
+</ul>
+</li>
+</ul>
+</li>
 </ul>
 </li>
 </ul>
@@ -2995,7 +3109,7 @@ TODO
 </li>
 <li><a href="#_how_tos">2. How-tos</a>
 <ul class="sectlevel2">
-<li><a href="#_class_members">2.1. Class Members</a>
+<li><a href="#_class_structure">2.1. Class Structure</a>
 <ul class="sectlevel3">
 <li><a href="#_class_definition">2.1.1. Class Definition</a></li>
 <li><a href="#_property">2.1.2. Property</a>
@@ -3061,7 +3175,12 @@ TODO
 <ul class="sectlevel3">
 <li><a href="#_icons_and_titles">2.6.1. Icons and Titles</a>
 <ul class="sectlevel4">
-<li><a href="#_object_title">Object Title</a></li>
+<li><a href="#_object_title">Object Title</a>
+<ul class="sectlevel5">
+<li><a href="#_titles_in_tables">Titles in Tables</a></li>
+<li><a href="#_hide_part_of_a_title">Hide part of a title</a></li>
+</ul>
+</li>
 <li><a href="#_object_icon">Object Icon</a></li>
 <li><a href="#_object_css_styling">Object CSS Styling</a></li>
 </ul>
@@ -3102,7 +3221,12 @@ TODO
 <li><a href="#_disable_a_collection">Disable a Collection</a></li>
 <li><a href="#_disable_an_action">Disable an Action</a></li>
 <li><a href="#_disable_a_contributed_property_collection_or_action">Disable a Contributed Property, Collection or Action</a></li>
-<li><a href="#_all_members_unmodifiable_disabling_the_edit_button">All Members Unmodifiable (Disabling the Edit Button)</a></li>
+<li><a href="#_all_members_unmodifiable_disabling_the_edit_button">All Members Unmodifiable (Disabling the Edit Button)</a>
+<ul class="sectlevel5">
+<li><a href="#_declarative">Declarative</a></li>
+<li><a href="#_imperative">Imperative</a></li>
+</ul>
+</li>
 </ul>
 </li>
 <li><a href="#_validity_do_it">2.7.3. Validity ("do it")</a>
@@ -3417,9 +3541,9 @@ TODO
 
 
 
-    <script src="../js/foundation/5.5.1/vendor/jquery.js"></script>
+<script src="../js/foundation/5.5.1/vendor/jquery.js"></script>
 
-    <script src="../js/foundation/5.5.1/foundation.min.js"></script>
+<script src="../js/foundation/5.5.1/foundation.min.js"></script>
 
 
 
@@ -3509,16 +3633,16 @@ TODO
 
 
 
-           //console.log("id = " + id + ", lastId = "  + lastId);
-
-
-
            if (lastId !== id && id) {
 
                scrollTo(id);
 
            }
 
+
+
+           window.history.pushState({}, "", window.location.origin + window.location.pathname + "#" + id);
+
         });
 
 
@@ -3627,10 +3751,6 @@ TODO
 
 
 
-        $("#toc").removeClass("hide");
-
-
-
         $(syncMenuItem).click();