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/04/15 23:26:50 UTC
[27/42] isis git commit: ISIS-1133: reworked template to use zurb
foundation, and reference the regular asciidoctor stylesheets;
skeleton outline of about half of the website.
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/css/foundation/5.5.1/normalize.css
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/css/foundation/5.5.1/normalize.css b/adocs/documentation/src/main/asciidoc/css/foundation/5.5.1/normalize.css
new file mode 100644
index 0000000..458eea1
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/css/foundation/5.5.1/normalize.css
@@ -0,0 +1,427 @@
+/*! normalize.css v3.0.2 | MIT License | git.io/normalize */
+
+/**
+ * 1. Set default font family to sans-serif.
+ * 2. Prevent iOS text size adjust after orientation change, without disabling
+ * user zoom.
+ */
+
+html {
+ font-family: sans-serif; /* 1 */
+ -ms-text-size-adjust: 100%; /* 2 */
+ -webkit-text-size-adjust: 100%; /* 2 */
+}
+
+/**
+ * Remove default margin.
+ */
+
+body {
+ margin: 0;
+}
+
+/* HTML5 display definitions
+ ========================================================================== */
+
+/**
+ * Correct `block` display not defined for any HTML5 element in IE 8/9.
+ * Correct `block` display not defined for `details` or `summary` in IE 10/11
+ * and Firefox.
+ * Correct `block` display not defined for `main` in IE 11.
+ */
+
+article,
+aside,
+details,
+figcaption,
+figure,
+footer,
+header,
+hgroup,
+main,
+menu,
+nav,
+section,
+summary {
+ display: block;
+}
+
+/**
+ * 1. Correct `inline-block` display not defined in IE 8/9.
+ * 2. Normalize vertical alignment of `progress` in Chrome, Firefox, and Opera.
+ */
+
+audio,
+canvas,
+progress,
+video {
+ display: inline-block; /* 1 */
+ vertical-align: baseline; /* 2 */
+}
+
+/**
+ * Prevent modern browsers from displaying `audio` without controls.
+ * Remove excess height in iOS 5 devices.
+ */
+
+audio:not([controls]) {
+ display: none;
+ height: 0;
+}
+
+/**
+ * Address `[hidden]` styling not present in IE 8/9/10.
+ * Hide the `template` element in IE 8/9/11, Safari, and Firefox < 22.
+ */
+
+[hidden],
+template {
+ display: none;
+}
+
+/* Links
+ ========================================================================== */
+
+/**
+ * Remove the gray background color from active links in IE 10.
+ */
+
+a {
+ background-color: transparent;
+}
+
+/**
+ * Improve readability when focused and also mouse hovered in all browsers.
+ */
+
+a:active,
+a:hover {
+ outline: 0;
+}
+
+/* Text-level semantics
+ ========================================================================== */
+
+/**
+ * Address styling not present in IE 8/9/10/11, Safari, and Chrome.
+ */
+
+abbr[title] {
+ border-bottom: 1px dotted;
+}
+
+/**
+ * Address style set to `bolder` in Firefox 4+, Safari, and Chrome.
+ */
+
+b,
+strong {
+ font-weight: bold;
+}
+
+/**
+ * Address styling not present in Safari and Chrome.
+ */
+
+dfn {
+ font-style: italic;
+}
+
+/**
+ * Address variable `h1` font-size and margin within `section` and `article`
+ * contexts in Firefox 4+, Safari, and Chrome.
+ */
+
+h1 {
+ font-size: 2em;
+ margin: 0.67em 0;
+}
+
+/**
+ * Address styling not present in IE 8/9.
+ */
+
+mark {
+ background: #ff0;
+ color: #000;
+}
+
+/**
+ * Address inconsistent and variable font size in all browsers.
+ */
+
+small {
+ font-size: 80%;
+}
+
+/**
+ * Prevent `sub` and `sup` affecting `line-height` in all browsers.
+ */
+
+sub,
+sup {
+ font-size: 75%;
+ line-height: 0;
+ position: relative;
+ vertical-align: baseline;
+}
+
+sup {
+ top: -0.5em;
+}
+
+sub {
+ bottom: -0.25em;
+}
+
+/* Embedded content
+ ========================================================================== */
+
+/**
+ * Remove border when inside `a` element in IE 8/9/10.
+ */
+
+img {
+ border: 0;
+}
+
+/**
+ * Correct overflow not hidden in IE 9/10/11.
+ */
+
+svg:not(:root) {
+ overflow: hidden;
+}
+
+/* Grouping content
+ ========================================================================== */
+
+/**
+ * Address margin not present in IE 8/9 and Safari.
+ */
+
+figure {
+ margin: 1em 40px;
+}
+
+/**
+ * Address differences between Firefox and other browsers.
+ */
+
+hr {
+ -moz-box-sizing: content-box;
+ box-sizing: content-box;
+ height: 0;
+}
+
+/**
+ * Contain overflow in all browsers.
+ */
+
+pre {
+ overflow: auto;
+}
+
+/**
+ * Address odd `em`-unit font size rendering in all browsers.
+ */
+
+code,
+kbd,
+pre,
+samp {
+ font-family: monospace, monospace;
+ font-size: 1em;
+}
+
+/* Forms
+ ========================================================================== */
+
+/**
+ * Known limitation: by default, Chrome and Safari on OS X allow very limited
+ * styling of `select`, unless a `border` property is set.
+ */
+
+/**
+ * 1. Correct color not being inherited.
+ * Known issue: affects color of disabled elements.
+ * 2. Correct font properties not being inherited.
+ * 3. Address margins set differently in Firefox 4+, Safari, and Chrome.
+ */
+
+button,
+input,
+optgroup,
+select,
+textarea {
+ color: inherit; /* 1 */
+ font: inherit; /* 2 */
+ margin: 0; /* 3 */
+}
+
+/**
+ * Address `overflow` set to `hidden` in IE 8/9/10/11.
+ */
+
+button {
+ overflow: visible;
+}
+
+/**
+ * Address inconsistent `text-transform` inheritance for `button` and `select`.
+ * All other form control elements do not inherit `text-transform` values.
+ * Correct `button` style inheritance in Firefox, IE 8/9/10/11, and Opera.
+ * Correct `select` style inheritance in Firefox.
+ */
+
+button,
+select {
+ text-transform: none;
+}
+
+/**
+ * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio`
+ * and `video` controls.
+ * 2. Correct inability to style clickable `input` types in iOS.
+ * 3. Improve usability and consistency of cursor style between image-type
+ * `input` and others.
+ */
+
+button,
+html input[type="button"], /* 1 */
+input[type="reset"],
+input[type="submit"] {
+ -webkit-appearance: button; /* 2 */
+ cursor: pointer; /* 3 */
+}
+
+/**
+ * Re-set default cursor for disabled elements.
+ */
+
+button[disabled],
+html input[disabled] {
+ cursor: default;
+}
+
+/**
+ * Remove inner padding and border in Firefox 4+.
+ */
+
+button::-moz-focus-inner,
+input::-moz-focus-inner {
+ border: 0;
+ padding: 0;
+}
+
+/**
+ * Address Firefox 4+ setting `line-height` on `input` using `!important` in
+ * the UA stylesheet.
+ */
+
+input {
+ line-height: normal;
+}
+
+/**
+ * It's recommended that you don't attempt to style these elements.
+ * Firefox's implementation doesn't respect box-sizing, padding, or width.
+ *
+ * 1. Address box sizing set to `content-box` in IE 8/9/10.
+ * 2. Remove excess padding in IE 8/9/10.
+ */
+
+input[type="checkbox"],
+input[type="radio"] {
+ box-sizing: border-box; /* 1 */
+ padding: 0; /* 2 */
+}
+
+/**
+ * Fix the cursor style for Chrome's increment/decrement buttons. For certain
+ * `font-size` values of the `input`, it causes the cursor style of the
+ * decrement button to change from `default` to `text`.
+ */
+
+input[type="number"]::-webkit-inner-spin-button,
+input[type="number"]::-webkit-outer-spin-button {
+ height: auto;
+}
+
+/**
+ * 1. Address `appearance` set to `searchfield` in Safari and Chrome.
+ * 2. Address `box-sizing` set to `border-box` in Safari and Chrome
+ * (include `-moz` to future-proof).
+ */
+
+input[type="search"] {
+ -webkit-appearance: textfield; /* 1 */
+ -moz-box-sizing: content-box;
+ -webkit-box-sizing: content-box; /* 2 */
+ box-sizing: content-box;
+}
+
+/**
+ * Remove inner padding and search cancel button in Safari and Chrome on OS X.
+ * Safari (but not Chrome) clips the cancel button when the search input has
+ * padding (and `textfield` appearance).
+ */
+
+input[type="search"]::-webkit-search-cancel-button,
+input[type="search"]::-webkit-search-decoration {
+ -webkit-appearance: none;
+}
+
+/**
+ * Define consistent border, margin, and padding.
+ */
+
+fieldset {
+ border: 1px solid #c0c0c0;
+ margin: 0 2px;
+ padding: 0.35em 0.625em 0.75em;
+}
+
+/**
+ * 1. Correct `color` not being inherited in IE 8/9/10/11.
+ * 2. Remove padding so people aren't caught out if they zero out fieldsets.
+ */
+
+legend {
+ border: 0; /* 1 */
+ padding: 0; /* 2 */
+}
+
+/**
+ * Remove default vertical scrollbar in IE 8/9/10/11.
+ */
+
+textarea {
+ overflow: auto;
+}
+
+/**
+ * Don't inherit the `font-weight` (applied by a rule above).
+ * NOTE: the default cannot safely be changed in Chrome and Safari on OS X.
+ */
+
+optgroup {
+ font-weight: bold;
+}
+
+/* Tables
+ ========================================================================== */
+
+/**
+ * Remove most spacing between table cells.
+ */
+
+table {
+ border-collapse: collapse;
+ border-spacing: 0;
+}
+
+td,
+th {
+ padding: 0;
+}
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/documentation.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/documentation.adoc b/adocs/documentation/src/main/asciidoc/documentation.adoc
new file mode 100644
index 0000000..10afc0e
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/documentation.adoc
@@ -0,0 +1,23 @@
+= Documentation
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
+:_basedir: ../
+:_imagesdir: images/
+:toc: right
+:numbered:
+
+Finding your way around:
+
+* Introducing Isis
+** link:introducing-isis/isis-in-pictures/isis-in-pictures.html[Isis in Pictures]
+** link:introducing-isis/common-use-cases/common-use-cases.html[Common Use Cases]
+* Getting Started
+** link:getting-started/archetype/simpleapp-archetype.html[SimpleApp Archetype]
+** Development Environments
+*** link:getting-started/development-environment/intellij-idea/intellij-idea.html[Intellij IDEA]
+*** link:getting-started/development-environment/eclipse/eclipse.html[Eclipse]
+*** link:getting-started/development-environment/cmd-line/cmd-line.html[(Maven) Command Line]
+* User Guide
+** link:user-guide/user-guide.html[User Guide]
+* Release Notes
+** link:release-notes/release-notes.html[Release Notes]
+
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/archetype/simpleapp-archetype.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/archetype/simpleapp-archetype.adoc b/adocs/documentation/src/main/asciidoc/getting-started/archetype/simpleapp-archetype.adoc
new file mode 100644
index 0000000..259706f
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/getting-started/archetype/simpleapp-archetype.adoc
@@ -0,0 +1,7 @@
+= SimpleApp Archetype
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
+:_basedir: ../../
+:_imagesdir: images/
+
+NOTE: TODO
+
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/cmd-line/cmd-line.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/cmd-line/cmd-line.adoc b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/cmd-line/cmd-line.adoc
new file mode 100644
index 0000000..b9e488c
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/cmd-line/cmd-line.adoc
@@ -0,0 +1,7 @@
+= Developing from the Command Line
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
+:_basedir: ../../../
+:_imagesdir: images/
+
+NOTE: TODO
+
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/eclipse/eclipse.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/eclipse/eclipse.adoc b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/eclipse/eclipse.adoc
new file mode 100644
index 0000000..6d493e4
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/eclipse/eclipse.adoc
@@ -0,0 +1,7 @@
+= Setting up Eclipse
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
+:_basedir: ../../../
+:_imagesdir: images/
+
+NOTE: TODO
+
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/010-welcome-page.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/010-welcome-page.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/010-welcome-page.png
deleted file mode 100644
index 24fbed3..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/010-welcome-page.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/020-choose-location.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/020-choose-location.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/020-choose-location.png
deleted file mode 100644
index 1d0cb46..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/020-choose-location.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/030-installation-options.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/030-installation-options.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/030-installation-options.png
deleted file mode 100644
index 01fbe56..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/030-installation-options.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/040-start-menu-folder.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/040-start-menu-folder.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/040-start-menu-folder.png
deleted file mode 100644
index dc850cc..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/040-start-menu-folder.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/050-completing.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/050-completing.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/050-completing.png
deleted file mode 100644
index 7b80e17..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/050-completing.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/060-import-settings-or-not.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/060-import-settings-or-not.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/060-import-settings-or-not.png
deleted file mode 100644
index 0054c4c..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/060-import-settings-or-not.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/070-set-ui-theme.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/070-set-ui-theme.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/070-set-ui-theme.png
deleted file mode 100644
index 247fc64..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/010-installing/070-set-ui-theme.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/010-new-project-create.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/010-new-project-create.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/010-new-project-create.png
deleted file mode 100644
index a950887..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/010-new-project-create.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/020-java-project-setup-jdk.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/020-java-project-setup-jdk.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/020-java-project-setup-jdk.png
deleted file mode 100644
index 16fe8d1..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/020-java-project-setup-jdk.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/030-java-project-select-jdk.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/030-java-project-select-jdk.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/030-java-project-select-jdk.png
deleted file mode 100644
index d0214c6..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/030-java-project-select-jdk.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/040-sdk-selected.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/040-sdk-selected.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/040-sdk-selected.png
deleted file mode 100644
index b9399d6..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/040-sdk-selected.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/050-name-and-location.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/050-name-and-location.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/050-name-and-location.png
deleted file mode 100644
index 7f3b8d6..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/050-name-and-location.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/060-create-dir.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/060-create-dir.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/060-create-dir.png
deleted file mode 100644
index 287478a..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/020-create-new-project/060-create-dir.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/010-settings-import-jar.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/010-settings-import-jar.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/010-settings-import-jar.png
deleted file mode 100644
index c607856..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/010-settings-import-jar.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/020-select-all.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/020-select-all.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/020-select-all.png
deleted file mode 100644
index 8e63a35..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/020-select-all.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/030-restart.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/030-restart.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/030-restart.png
deleted file mode 100644
index c20e0ac..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/030-import-settings/030-restart.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/010-maven-installation.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/010-maven-installation.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/010-maven-installation.png
deleted file mode 100644
index 9fef693..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/010-maven-installation.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/020-maven-configuration.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/020-maven-configuration.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/020-maven-configuration.png
deleted file mode 100644
index 945968d..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/020-maven-configuration.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/030-build-automatically.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/030-build-automatically.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/030-build-automatically.png
deleted file mode 100644
index b383b3c..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/040-other-settings/030-build-automatically.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/050-some-plugins/010-some-plugins.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/050-some-plugins/010-some-plugins.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/050-some-plugins/010-some-plugins.png
deleted file mode 100644
index 9e2230b..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/050-some-plugins/010-some-plugins.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png
deleted file mode 100644
index 037c967..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/010-maven-modules-view.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/010-maven-modules-view.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/010-maven-modules-view.png
deleted file mode 100644
index a5b8944..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/010-maven-modules-view.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/020-adding-another-module.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/020-adding-another-module.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/020-adding-another-module.png
deleted file mode 100644
index b8e9ba9..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/020-adding-another-module.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/030-other-module-added.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/030-other-module-added.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/030-other-module-added.png
deleted file mode 100644
index 58b42f0..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/030-other-module-added.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/040-ignoring-modules.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/040-ignoring-modules.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/040-ignoring-modules.png
deleted file mode 100644
index 0421f99..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/040-ignoring-modules.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/050-ignoring-modules-2.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/050-ignoring-modules-2.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/050-ignoring-modules-2.png
deleted file mode 100644
index 6bf26ac..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/050-ignoring-modules-2.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/060-ignored-modules.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/060-ignored-modules.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/060-ignored-modules.png
deleted file mode 100644
index b16086b..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/images/intellij-idea/100-maven-module-mgmt/060-ignored-modules.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-ce.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-ce.adoc b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-ce.adoc
deleted file mode 100644
index 28e571a..0000000
--- a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-ce.adoc
+++ /dev/null
@@ -1,164 +0,0 @@
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
-:_basedir: ../../
-
-#### Setting up IntelliJ (Community Edition)
-
-NOTE: This doc used IntelliJ CE 14.1.1, with screenshots taken for Windows. If you're a MacOS user, I'm sure you can adapt :-)
-
-##### Download and Install
-
-https://www.jetbrains.com/idea/download/[Download] latest version of IntelliJ Community Edition, and install:
-
-Start the wizard, click through the welcome page:
-
-.IntelliJ Installation Wizard - Welcome page
-image::images/intellij-idea/010-installing/010-welcome-page.png[width="400px"]
-
-Choose the location to install the IDE:
-
-.IntelliJ Installation Wizard - Choose Location
-image::images/intellij-idea/010-installing/020-choose-location.png[width="400px"]
-
-Adjust any installation options as you prefer:
-
-.IntelliJ Installation Wizard - Installation Options
-image::images/intellij-idea/010-installing/030-installation-options.png[width="400px"]
-
-and the start menu:
-
-.IntelliJ Installation Wizard - Start Menu Folder
-image::images/intellij-idea/010-installing/040-start-menu-folder.png[width="400px"]
-
-and finish up the wizard:
-
-.IntelliJ Installation Wizard - Completing the Wizard
-image::images/intellij-idea/010-installing/050-completing.png[width="400px"]
-
-Later on we'll specify the Apache Isis/ASF code style settings, so for now select `I do not want to import settings`:
-
-.IntelliJ Installation Wizard - Import Settings
-image::images/intellij-idea/010-installing/060-import-settings-or-not.png[width="400px"]
-
-Finally, if you are young and trendy, set the UI theme to Darcula:
-
-.IntelliJ Installation Wizard Set UI Theme
-image::images/intellij-idea/010-installing/070-set-ui-theme.png[width="600px"]
-
-
-##### New Project
-
-In IntelliJ a project can contain multiple modules; these need not be physically located together. (If you are previously an Eclipse user, it is therefore similar to an Eclipse workspace).
-
-Start off by creating a new project:
-
-.IntelliJ Create New Project
-image::images/intellij-idea/020-create-new-project/010-new-project-create.png[width="400px"]
-
-We want to create a new *Java* project:
-
-.IntelliJ Create New Project - Create a Java project
-image::images/intellij-idea/020-create-new-project/020-java-project-setup-jdk.png[width="600px"]
-
-We therefore need to specify the JDK.
-
-NOTE: at the time of writing Isis supports only Java 7; Java 8 is scheduled for support in Isis v1.9.0
-
-
-.IntelliJ Create New Java Project - Select the JDK
-image::images/intellij-idea/020-create-new-project/030-java-project-select-jdk.png[width="300px"]
-
-Specify the directory containing the JDK:
-
-.IntelliJ Create New Project - Select the JDK location
-image::images/intellij-idea/020-create-new-project/050-name-and-location.png[width="400px"]
-
-Finally allow IntelliJ to create the directory for the new project:
-
-.IntelliJ Create New Project
-image::images/intellij-idea/020-create-new-project/060-create-dir.png[width="200px"]
-
-##### Import Settings
-
-Next we need to configure IntelliJ with ASF/Apache Isis' standard templates and coding conventions. These are bundled as the `isis-settings.jar` JAR file (available from the Isis website).
-
-Import using: `File > Import Settings`, and specify the directory that you have downloaded the file to:
-
-.IntelliJ Import Settings - Specify JAR file
-image::images/intellij-idea/030-import-settings/010-settings-import-jar.png[width="400px"]
-
-Select all the (two) categories of settings available in the JAR file:
-
-.IntelliJ Import Settings - Select all categories
-image::images/intellij-idea/030-import-settings/020-select-all.png[width="300px"]
-
-And then restart:
-
-.IntelliJ Import Settings - Restart
-image::images/intellij-idea/030-import-settings/030-restart.png[width="200px"]
-
-##### Other Settings
-
-There are also some other miscellaneous settings that we recommend that you adjust.
-
-First, specify an up-to-date Maven installation, using `File > Settings` (or `IntelliJ > Preferences` if on MacOS):
-
-.IntelliJ Import Settings - Maven Installation
-image::images/intellij-idea/040-other-settings/010-maven-installation.png[width="600px"]
-
-Still on the Maven settings page, configure as follows:
-
-.IntelliJ Import Settings - Maven Configuration
-image::images/intellij-idea/040-other-settings/020-maven-configuration.png[width="600px"]
-
-And on the compiler settings page, ensure that `build automatically` is enabled (and optionally `compile independent modules in parallel`):
-
-.IntelliJ Import Settings - Compiler Settings
-image::images/intellij-idea/040-other-settings/030-build-automatically.png[width="600px"]
-
-##### Some Plugins
-
-Next, you might want to set up some additional plugins, using `File > Settings > Plugins` (or equivalently `File > Other Settings > Configure Plugins`).
-
-Some to get you started are:
-
-.IntelliJ Plugins
-image::images/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png[width="400px"]
-
-##### Importing and Managing Maven Modules
-
-Finally, let's load in some actual code! We do this by importing the Maven modules.
-
-First up, open up the Maven tool window (`View > Tool Windows > Maven Projects`). You can then use the 'plus' button to add Maven modules. In the screenshot you can see we've loaded in Isis core; the modules are listed in the _Maven Projects_ window and corresponding (IntelliJ) modules are shown in the _Projects_ window:
-
-.IntelliJ Maven Module Management - Importing Maven modules
-image::images/intellij-idea/100-maven-module-mgmt/010-maven-modules-view.png[width="730px"]
-
-We can then import another module (from some other directory). For example, here we are importing the Isis Addons' todoapp example:
-
-.IntelliJ Maven Module Management - Importing another Module
-image::images/intellij-idea/100-maven-module-mgmt/020-adding-another-module.png[width="400px"]
-
-You should then see the new Maven module loaded in the _Projects_ window and also the _Maven Projects_ window:
-
-.IntelliJ Maven Module Management -
-image::images/intellij-idea/100-maven-module-mgmt/030-other-module-added.png[width="730px"]
-
-If any dependencies are already loaded in the project, then IntelliJ will automatically update the CLASSPATH to resolve to locally held modules (rather from `.m2/repository` folder). So, for example (assuming that the `<version>` is correct, of course), the Isis todoapp will have local dependencies on the Isis core.
-
-You can press F4 (or use `File > Project Structure`) to see the resolved classpath for any of the modules loaded into the project.
-
-If you want to focus on one set of code (eg the Isis todoapp but not Isis core) then you _could_ remove the module; but better is to ignore those modules. This will remove from the the _Projects_ window but keep them available in the _Maven Projects_ window for when you next want to work on them:
-
-.IntelliJ Maven Module Management - Ignoring Modules
-image::images/intellij-idea/100-maven-module-mgmt/040-ignoring-modules.png[width="730px"]
-
-Confirm that it's ok to ignore these modules:
-
-.IntelliJ Maven Module Management -
-image::images/intellij-idea/100-maven-module-mgmt/050-ignoring-modules-2.png[width="300px"]
-
-All being well you should see that the _Projects_ window now only contains the code you are working on. Its classpath dependencies will be adjusted (eg to resolve to Isis core from `.m2/repository`):
-
-.IntelliJ Maven Module Management -
-image::images/intellij-idea/100-maven-module-mgmt/060-ignored-modules.png[width="730px"]
-
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/010-welcome-page.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/010-welcome-page.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/010-welcome-page.png
new file mode 100644
index 0000000..24fbed3
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/010-welcome-page.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/020-choose-location.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/020-choose-location.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/020-choose-location.png
new file mode 100644
index 0000000..1d0cb46
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/020-choose-location.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/030-installation-options.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/030-installation-options.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/030-installation-options.png
new file mode 100644
index 0000000..01fbe56
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/030-installation-options.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/040-start-menu-folder.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/040-start-menu-folder.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/040-start-menu-folder.png
new file mode 100644
index 0000000..dc850cc
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/040-start-menu-folder.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/050-completing.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/050-completing.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/050-completing.png
new file mode 100644
index 0000000..7b80e17
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/050-completing.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/060-import-settings-or-not.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/060-import-settings-or-not.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/060-import-settings-or-not.png
new file mode 100644
index 0000000..0054c4c
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/060-import-settings-or-not.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/070-set-ui-theme.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/070-set-ui-theme.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/070-set-ui-theme.png
new file mode 100644
index 0000000..247fc64
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/070-set-ui-theme.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/010-new-project-create.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/010-new-project-create.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/010-new-project-create.png
new file mode 100644
index 0000000..a950887
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/010-new-project-create.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/020-java-project-setup-jdk.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/020-java-project-setup-jdk.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/020-java-project-setup-jdk.png
new file mode 100644
index 0000000..16fe8d1
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/020-java-project-setup-jdk.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/030-java-project-select-jdk.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/030-java-project-select-jdk.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/030-java-project-select-jdk.png
new file mode 100644
index 0000000..d0214c6
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/030-java-project-select-jdk.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/040-sdk-selected.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/040-sdk-selected.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/040-sdk-selected.png
new file mode 100644
index 0000000..b9399d6
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/040-sdk-selected.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/050-name-and-location.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/050-name-and-location.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/050-name-and-location.png
new file mode 100644
index 0000000..7f3b8d6
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/050-name-and-location.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/060-create-dir.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/060-create-dir.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/060-create-dir.png
new file mode 100644
index 0000000..287478a
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/060-create-dir.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/010-settings-import-jar.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/010-settings-import-jar.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/010-settings-import-jar.png
new file mode 100644
index 0000000..c607856
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/010-settings-import-jar.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/020-select-all.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/020-select-all.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/020-select-all.png
new file mode 100644
index 0000000..8e63a35
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/020-select-all.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/030-restart.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/030-restart.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/030-restart.png
new file mode 100644
index 0000000..c20e0ac
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/030-restart.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/010-maven-installation.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/010-maven-installation.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/010-maven-installation.png
new file mode 100644
index 0000000..9fef693
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/010-maven-installation.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/020-maven-configuration.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/020-maven-configuration.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/020-maven-configuration.png
new file mode 100644
index 0000000..945968d
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/020-maven-configuration.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/030-build-automatically.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/030-build-automatically.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/030-build-automatically.png
new file mode 100644
index 0000000..b383b3c
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/030-build-automatically.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/040-auto-import.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/040-auto-import.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/040-auto-import.png
new file mode 100644
index 0000000..293d2c3
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/040-auto-import.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/010-some-plugins.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/010-some-plugins.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/010-some-plugins.png
new file mode 100644
index 0000000..9e2230b
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/010-some-plugins.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/020-some-plugins-confirmation.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/020-some-plugins-confirmation.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/020-some-plugins-confirmation.png
new file mode 100644
index 0000000..037c967
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/020-some-plugins-confirmation.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/010-maven-modules-view.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/010-maven-modules-view.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/010-maven-modules-view.png
new file mode 100644
index 0000000..a5b8944
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/010-maven-modules-view.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/020-adding-another-module.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/020-adding-another-module.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/020-adding-another-module.png
new file mode 100644
index 0000000..b8e9ba9
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/020-adding-another-module.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/030-other-module-added.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/030-other-module-added.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/030-other-module-added.png
new file mode 100644
index 0000000..58b42f0
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/030-other-module-added.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/040-ignoring-modules.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/040-ignoring-modules.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/040-ignoring-modules.png
new file mode 100644
index 0000000..0421f99
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/040-ignoring-modules.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/050-ignoring-modules-2.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/050-ignoring-modules-2.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/050-ignoring-modules-2.png
new file mode 100644
index 0000000..6bf26ac
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/050-ignoring-modules-2.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/060-ignored-modules.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/060-ignored-modules.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/060-ignored-modules.png
new file mode 100644
index 0000000..b16086b
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/060-ignored-modules.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/intellij-idea.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/intellij-idea.adoc b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/intellij-idea.adoc
new file mode 100644
index 0000000..7ea0923
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/intellij-idea.adoc
@@ -0,0 +1,171 @@
+= Setting up IntelliJ IDEA
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
+:_basedir: ../../../
+:_imagesdir: images/
+:toc: right
+
+
+NOTE: This doc used IntelliJ Community Edition 14.1.1, with screenshots taken for Windows. If you're a MacOS user, I'm sure you can adapt :-)
+
+## Download and Install
+
+https://www.jetbrains.com/idea/download/[Download] latest version of IntelliJ Community Edition, and install:
+
+Start the wizard, click through the welcome page:
+
+.IntelliJ Installation Wizard - Welcome page
+image::{_imagesdir}010-installing/010-welcome-page.png[width="400px"]
+
+Choose the location to install the IDE:
+
+.IntelliJ Installation Wizard - Choose Location
+image::{_imagesdir}010-installing/020-choose-location.png[width="400px"]
+
+Adjust any installation options as you prefer:
+
+.IntelliJ Installation Wizard - Installation Options
+image::{_imagesdir}010-installing/030-installation-options.png[width="400px"]
+
+and the start menu:
+
+.IntelliJ Installation Wizard - Start Menu Folder
+image::{_imagesdir}010-installing/040-start-menu-folder.png[width="400px"]
+
+and finish up the wizard:
+
+.IntelliJ Installation Wizard - Completing the Wizard
+image::{_imagesdir}010-installing/050-completing.png[width="400px"]
+
+Later on we'll specify the Apache Isis/ASF code style settings, so for now select `I do not want to import settings`:
+
+.IntelliJ Installation Wizard - Import Settings
+image::{_imagesdir}010-installing/060-import-settings-or-not.png[width="400px"]
+
+Finally, if you are young and trendy, set the UI theme to Darcula:
+
+.IntelliJ Installation Wizard Set UI Theme
+image::{_imagesdir}010-installing/070-set-ui-theme.png[width="600px"]
+
+
+## New Project
+
+In IntelliJ a project can contain multiple modules; these need not be physically located together. (If you are previously an Eclipse user, it is therefore similar to an Eclipse workspace).
+
+Start off by creating a new project:
+
+.IntelliJ Create New Project
+image::{_imagesdir}020-create-new-project/010-new-project-create.png[width="400px"]
+
+We want to create a new *Java* project:
+
+.IntelliJ Create New Project - Create a Java project
+image::{_imagesdir}020-create-new-project/020-java-project-setup-jdk.png[width="600px"]
+
+We therefore need to specify the JDK.
+
+NOTE: at the time of writing Isis supports only Java 7; Java 8 is scheduled for support in Isis v1.9.0
+
+
+.IntelliJ Create New Java Project - Select the JDK
+image::{_imagesdir}020-create-new-project/030-java-project-select-jdk.png[width="300px"]
+
+Specify the directory containing the JDK:
+
+.IntelliJ Create New Project - Select the JDK location
+image::{_imagesdir}020-create-new-project/050-name-and-location.png[width="400px"]
+
+Finally allow IntelliJ to create the directory for the new project:
+
+.IntelliJ Create New Project
+image::{_imagesdir}020-create-new-project/060-create-dir.png[width="200px"]
+
+## Import Settings
+
+Next we need to configure IntelliJ with ASF/Apache Isis' standard templates and coding conventions. These are bundled as the `settings.jar` JAR file link:resources/isis-settings.jar[download from the Isis website]).
+
+Import using: `File > Import Settings`, and specify the directory that you have downloaded the file to:
+
+.IntelliJ Import Settings - Specify JAR file
+image::{_imagesdir}030-import-settings/010-settings-import-jar.png[width="400px"]
+
+Select all the (two) categories of settings available in the JAR file:
+
+.IntelliJ Import Settings - Select all categories
+image::{_imagesdir}030-import-settings/020-select-all.png[width="300px"]
+
+And then restart:
+
+.IntelliJ Import Settings - Restart
+image::{_imagesdir}030-import-settings/030-restart.png[width="200px"]
+
+## Other Settings
+
+There are also some other miscellaneous settings that we recommend that you adjust.
+
+First, specify an up-to-date Maven installation, using `File > Settings` (or `IntelliJ > Preferences` if on MacOS):
+
+.IntelliJ Import Settings - Maven Installation
+image::{_imagesdir}040-other-settings/010-maven-installation.png[width="600px"]
+
+Still on the Maven settings page, configure as follows:
+
+.IntelliJ Import Settings - Maven Configuration
+image::{_imagesdir}040-other-settings/020-maven-configuration.png[width="600px"]
+
+And on the compiler settings page, ensure that `build automatically` is enabled (and optionally `compile independent modules in parallel`):
+
+.IntelliJ Import Settings - Compiler Settings
+image::{_imagesdir}040-other-settings/030-build-automatically.png[width="600px"]
+
+## Some Plugins
+
+Next, you might want to set up some additional plugins, using `File > Settings > Plugins` (or equivalently `File > Other Settings > Configure Plugins`).
+
+Some to get you started are:
+
+.IntelliJ Plugins
+image::{_imagesdir}050-some-plugins/020-some-plugins-confirmation.png[width="400px"]
+
+## Importing and Managing Maven Modules
+
+Finally, let's load in some actual code! We do this by importing the Maven modules.
+
+First up, open up the Maven tool window (`View > Tool Windows > Maven Projects`). You can then use the 'plus' button to add Maven modules. In the screenshot you can see we've loaded in Isis core; the modules are listed in the _Maven Projects_ window and corresponding (IntelliJ) modules are shown in the _Projects_ window:
+
+.IntelliJ Maven Module Management - Importing Maven modules
+image::{_imagesdir}100-maven-module-mgmt/010-maven-modules-view.png[width="730px"]
+
+We can then import another module (from some other directory). For example, here we are importing the Isis Addons' todoapp example:
+
+.IntelliJ Maven Module Management - Importing another Module
+image::{_imagesdir}100-maven-module-mgmt/020-adding-another-module.png[width="400px"]
+
+You should then see the new Maven module loaded in the _Projects_ window and also the _Maven Projects_ window:
+
+.IntelliJ Maven Module Management -
+image::{_imagesdir}100-maven-module-mgmt/030-other-module-added.png[width="730px"]
+
+If any dependencies are already loaded in the project, then IntelliJ will automatically update the CLASSPATH to resolve to locally held modules (rather from `.m2/repository` folder). So, for example (assuming that the `<version>` is correct, of course), the Isis todoapp will have local dependencies on the Isis core.
+
+You can press F4 (or use `File > Project Structure`) to see the resolved classpath for any of the modules loaded into the project.
+
+If you want to focus on one set of code (eg the Isis todoapp but not Isis core) then you _could_ remove the module; but better is to ignore those modules. This will remove from the the _Projects_ window but keep them available in the _Maven Projects_ window for when you next want to work on them:
+
+.IntelliJ Maven Module Management - Ignoring Modules
+image::{_imagesdir}100-maven-module-mgmt/040-ignoring-modules.png[width="730px"]
+
+Confirm that it's ok to ignore these modules:
+
+.IntelliJ Maven Module Management -
+image::{_imagesdir}100-maven-module-mgmt/050-ignoring-modules-2.png[width="300px"]
+
+All being well you should see that the _Projects_ window now only contains the code you are working on. Its classpath dependencies will be adjusted (eg to resolve to Isis core from `.m2/repository`):
+
+.IntelliJ Maven Module Management -
+image::{_imagesdir}100-maven-module-mgmt/060-ignored-modules.png[width="730px"]
+
+
+
+## Dynamically Reloading
+
+NOTE: TODO
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/index.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/index.adoc b/adocs/documentation/src/main/asciidoc/index.adoc
deleted file mode 100644
index ce92e70..0000000
--- a/adocs/documentation/src/main/asciidoc/index.adoc
+++ /dev/null
@@ -1,26 +0,0 @@
-= Documentation
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
-:toc: right
-:numbered:
-:_basedir: ./
-
-
-## Introducing Apache Isis
-
-:imagesdir: introducing-apache-isis
-include::introducing-apache-isis/elevator-pitch.adoc[leveloffset=+1]
-
-
-## Getting Started
-
-### Archetypes and Apps
-
-### Development Environment
-
-:imagesdir: getting-started/development-environment
-include::getting-started/development-environment/intellij-ce.adoc[leveloffset=+1]
-
-## Release Notes
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/introducing-apache-isis/common-use-cases/common-use-cases.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/introducing-apache-isis/common-use-cases/common-use-cases.adoc b/adocs/documentation/src/main/asciidoc/introducing-apache-isis/common-use-cases/common-use-cases.adoc
new file mode 100644
index 0000000..075034f
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/introducing-apache-isis/common-use-cases/common-use-cases.adoc
@@ -0,0 +1,6 @@
+=Common Use Cases
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
+:_basedir: ../../
+:_imagesdir: images/
+
+NOTE: TODO
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/introducing-apache-isis/elevator-pitch.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/introducing-apache-isis/elevator-pitch.adoc b/adocs/documentation/src/main/asciidoc/introducing-apache-isis/elevator-pitch.adoc
deleted file mode 100644
index 1bd4e8a..0000000
--- a/adocs/documentation/src/main/asciidoc/introducing-apache-isis/elevator-pitch.adoc
+++ /dev/null
@@ -1,4 +0,0 @@
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
-
-IMPORTANT: todo
-
http://git-wip-us.apache.org/repos/asf/isis/blob/f95f3453/adocs/documentation/src/main/asciidoc/introducing-apache-isis/isis-in-pictures/isis-in-pictures.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/introducing-apache-isis/isis-in-pictures/isis-in-pictures.adoc b/adocs/documentation/src/main/asciidoc/introducing-apache-isis/isis-in-pictures/isis-in-pictures.adoc
new file mode 100644
index 0000000..32f9c33
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/introducing-apache-isis/isis-in-pictures/isis-in-pictures.adoc
@@ -0,0 +1,7 @@
+=Isis in Pictures
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. 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.
+:_basedir: ../../
+:_imagesdir: images/
+
+NOTE: TODO
+