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/27 21:31:54 UTC
[04/11] isis git commit: ISIS-1133: reorganizing some of the new
adocs; developing script for instant local rebuild / preview.
ISIS-1133: reorganizing some of the new adocs; developing script for instant local rebuild / preview.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/90f26cf6
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/90f26cf6
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/90f26cf6
Branch: refs/heads/ISIS-1133
Commit: 90f26cf662ffa849a4c44297f8ae7ca75e2fdde6
Parents: 072527a
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Mon Apr 27 07:30:48 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Mon Apr 27 07:30:48 2015 +0100
----------------------------------------------------------------------
adocs/documentation/Gemfile | 13 +
adocs/documentation/Gemfile.lock | 30 ++
adocs/documentation/README.md | 37 +-
adocs/documentation/listen.rb | 95 +++++
.../archetype/simpleapp-archetype.adoc | 7 -
.../images/010-installing/010-welcome-page.png | Bin 29192 -> 0 bytes
.../010-installing/020-choose-location.png | Bin 24433 -> 0 bytes
.../010-installing/030-installation-options.png | Bin 18300 -> 0 bytes
.../010-installing/040-start-menu-folder.png | Bin 26120 -> 0 bytes
.../images/010-installing/050-completing.png | Bin 26499 -> 0 bytes
.../060-import-settings-or-not.png | Bin 11691 -> 0 bytes
.../images/010-installing/070-set-ui-theme.png | Bin 87739 -> 0 bytes
.../010-new-project-create.png | Bin 14048 -> 0 bytes
.../020-java-project-setup-jdk.png | Bin 29837 -> 0 bytes
.../030-java-project-select-jdk.png | Bin 16597 -> 0 bytes
.../020-create-new-project/040-sdk-selected.png | Bin 24884 -> 0 bytes
.../050-name-and-location.png | Bin 11407 -> 0 bytes
.../020-create-new-project/060-create-dir.png | Bin 8424 -> 0 bytes
.../010-settings-import-jar.png | Bin 24084 -> 0 bytes
.../030-import-settings/020-select-all.png | Bin 8863 -> 0 bytes
.../images/030-import-settings/030-restart.png | Bin 8209 -> 0 bytes
.../010-maven-installation.png | Bin 43353 -> 0 bytes
.../020-maven-configuration.png | Bin 53554 -> 0 bytes
.../030-build-automatically.png | Bin 50767 -> 0 bytes
.../040-other-settings/040-auto-import.png | Bin 31963 -> 0 bytes
.../050-some-plugins/010-some-plugins.png | Bin 45812 -> 0 bytes
.../020-some-plugins-confirmation.png | Bin 35687 -> 0 bytes
.../010-maven-modules-view.png | Bin 103134 -> 0 bytes
.../020-adding-another-module.png | Bin 23846 -> 0 bytes
.../030-other-module-added.png | Bin 111516 -> 0 bytes
.../040-ignoring-modules.png | Bin 120475 -> 0 bytes
.../050-ignoring-modules-2.png | Bin 17050 -> 0 bytes
.../060-ignored-modules.png | Bin 92428 -> 0 bytes
.../010-run-configuration.png | Bin 34826 -> 0 bytes
.../020-datanucleus-enhancer-goal.png | Bin 8491 -> 0 bytes
.../030-running-unit-tests.png | Bin 29351 -> 0 bytes
...040-running-unit-tests-run-configuration.png | Bin 37582 -> 0 bytes
...ning-integration-tests-run-configuration.png | Bin 40655 -> 0 bytes
.../intellij-idea/intellij-idea.adoc | 362 -------------------
.../010-installing/010-welcome-page.png | Bin 0 -> 29192 bytes
.../010-installing/020-choose-location.png | Bin 0 -> 24433 bytes
.../010-installing/030-installation-options.png | Bin 0 -> 18300 bytes
.../010-installing/040-start-menu-folder.png | Bin 0 -> 26120 bytes
.../010-installing/050-completing.png | Bin 0 -> 26499 bytes
.../060-import-settings-or-not.png | Bin 0 -> 11691 bytes
.../010-installing/070-set-ui-theme.png | Bin 0 -> 87739 bytes
.../010-new-project-create.png | Bin 0 -> 14048 bytes
.../020-java-project-setup-jdk.png | Bin 0 -> 29837 bytes
.../030-java-project-select-jdk.png | Bin 0 -> 16597 bytes
.../020-create-new-project/040-sdk-selected.png | Bin 0 -> 24884 bytes
.../050-name-and-location.png | Bin 0 -> 11407 bytes
.../020-create-new-project/060-create-dir.png | Bin 0 -> 8424 bytes
.../010-settings-import-jar.png | Bin 0 -> 24084 bytes
.../030-import-settings/020-select-all.png | Bin 0 -> 8863 bytes
.../030-import-settings/030-restart.png | Bin 0 -> 8209 bytes
.../010-maven-installation.png | Bin 0 -> 43353 bytes
.../020-maven-configuration.png | Bin 0 -> 53554 bytes
.../030-build-automatically.png | Bin 0 -> 50767 bytes
.../040-other-settings/040-auto-import.png | Bin 0 -> 31963 bytes
.../050-some-plugins/010-some-plugins.png | Bin 0 -> 45812 bytes
.../020-some-plugins-confirmation.png | Bin 0 -> 35687 bytes
.../010-maven-modules-view.png | Bin 0 -> 103134 bytes
.../020-adding-another-module.png | Bin 0 -> 23846 bytes
.../030-other-module-added.png | Bin 0 -> 111516 bytes
.../040-ignoring-modules.png | Bin 0 -> 120475 bytes
.../050-ignoring-modules-2.png | Bin 0 -> 17050 bytes
.../060-ignored-modules.png | Bin 0 -> 92428 bytes
.../010-run-configuration.png | Bin 0 -> 34826 bytes
.../020-datanucleus-enhancer-goal.png | Bin 0 -> 8491 bytes
.../030-running-unit-tests.png | Bin 0 -> 29351 bytes
...040-running-unit-tests-run-configuration.png | Bin 0 -> 37582 bytes
...ning-integration-tests-run-configuration.png | Bin 0 -> 40655 bytes
.../tips-n-tricks/are-you-sure-happy-case.png | Bin 0 -> 9993 bytes
.../tips-n-tricks/are-you-sure-sad-case.png | Bin 0 -> 10515 bytes
.../how-tos/tips-n-tricks/are-you-sure.png | Bin 0 -> 9312 bytes
...os-tips-n-tricks-are-you-sure-happy-case.png | Bin 9993 -> 0 bytes
...-tos-tips-n-tricks-are-you-sure-sad-case.png | Bin 10515 -> 0 bytes
...guide-how-tos-tips-n-tricks-are-you-sure.png | Bin 9312 -> 0 bytes
.../user-guide-config-and-deployment.adoc | 93 -----
...user-guide-core-concepts-apache-isis-vs.adoc | 14 -
...ser-guide-core-concepts-building-blocks.adoc | 234 ------------
...re-concepts-framework-provided-services.adoc | 82 -----
.../user-guide-core-concepts-principles.adoc | 73 ----
.../user-guide/user-guide-core-concepts.adoc | 20 -
.../user-guide-extending-programming-model.adoc | 16 -
.../user-guide/user-guide-extending.adoc | 27 --
.../user-guide-how-tos-business-rules.adoc | 57 ---
.../user-guide-how-tos-class-structure.adoc | 173 ---------
.../user-guide-how-tos-contributed-members.adoc | 15 -
.../user-guide/user-guide-how-tos-crud.adoc | 18 -
.../user-guide-how-tos-derived-members.adoc | 33 --
...r-guide-how-tos-drop-downs-and-defaults.adoc | 30 --
...user-guide-how-tos-entity-relationships.adoc | 11 -
.../user-guide-how-tos-error-handling.adoc | 11 -
.../user-guide/user-guide-how-tos-i18n.adoc | 7 -
.../user-guide-how-tos-multi-tenancy.adoc | 7 -
...ser-guide-how-tos-persistence-lifecycle.adoc | 7 -
...uide-how-tos-tips-n-tricks-are-you-sure.adoc | 47 ---
...ips-n-tricks-overriding-jdo-annotations.adoc | 5 -
.../user-guide-how-tos-tips-n-tricks.adoc | 32 --
.../user-guide-how-tos-triggering-events.adoc | 136 -------
.../user-guide/user-guide-how-tos-ui-hints.adoc | 55 ---
.../asciidoc/user-guide/user-guide-how-tos.adoc | 39 --
...er-guide-integrating-with-other-systems.adoc | 11 -
.../user-guide/user-guide-isis-addons.adoc | 44 ---
...-guide-reference-applib-utility-classes.adoc | 144 --------
.../user-guide-reference-cmd-line-args.adoc | 31 --
...uide-reference-convenience-superclasses.adoc | 8 -
.../user-guide-reference-domain-services.adoc | 8 -
...-guide-reference-recognized-annotations.adoc | 8 -
...nce-recognized-configuration-properties.adoc | 28 --
...user-guide-reference-recognized-methods.adoc | 8 -
.../user-guide-reference-value-types.adoc | 14 -
.../user-guide-reference-web-xml.adoc | 8 -
.../user-guide/user-guide-reference.adoc | 25 --
.../user-guide/user-guide-restful-viewer.adoc | 35 --
...er-guide-testing-bdd-integ-test-support.adoc | 7 -
.../user-guide-testing-fake-data.adoc | 11 -
.../user-guide-testing-fixture-scripts.adoc | 65 ----
.../user-guide-testing-integ-test-support.adoc | 19 -
.../user-guide-testing-unit-test-support.adoc | 200 ----------
.../asciidoc/user-guide/user-guide-testing.adoc | 22 --
...ide-troubleshooting-datanucleus-logging.adoc | 10 -
.../user-guide/user-guide-troubleshooting.adoc | 13 -
.../user-guide/user-guide-wicket-viewer.adoc | 74 ----
.../main/asciidoc/user-guide/user-guide.adoc | 28 +-
.../user-guide/user-guide_appendices.adoc | 8 +
.../user-guide_appendices_dev-env.adoc | 8 +
.../user-guide_appendices_dev-env_intellij.adoc | 362 +++++++++++++++++++
.../user-guide_background-execution.adoc | 40 ++
.../user-guide_config-and-deployment.adoc | 93 +++++
.../user-guide/user-guide_core-concepts.adoc | 20 +
...user-guide_core-concepts_apache-isis-vs.adoc | 14 +
...ser-guide_core-concepts_building-blocks.adoc | 234 ++++++++++++
...re-concepts_framework-provided-services.adoc | 82 +++++
.../user-guide_core-concepts_principles.adoc | 73 ++++
.../user-guide/user-guide_extending.adoc | 25 ++
.../user-guide_extending_programming-model.adoc | 16 +
.../user-guide/user-guide_getting-started.adoc | 9 +
...ide_getting-started_simpleapp-archetype.adoc | 7 +
.../asciidoc/user-guide/user-guide_how-tos.adoc | 39 ++
.../user-guide_how-tos_business-rules.adoc | 57 +++
.../user-guide_how-tos_class-structure.adoc | 173 +++++++++
.../user-guide_how-tos_contributed-members.adoc | 15 +
.../user-guide/user-guide_how-tos_crud.adoc | 18 +
.../user-guide_how-tos_derived-members.adoc | 33 ++
...r-guide_how-tos_drop-downs-and-defaults.adoc | 30 ++
...user-guide_how-tos_entity-relationships.adoc | 11 +
.../user-guide_how-tos_error-handling.adoc | 11 +
.../user-guide/user-guide_how-tos_i18n.adoc | 7 +
.../user-guide_how-tos_multi-tenancy.adoc | 7 +
...ser-guide_how-tos_persistence-lifecycle.adoc | 7 +
.../user-guide_how-tos_tips-n-tricks.adoc | 32 ++
...uide_how-tos_tips-n-tricks_are-you-sure.adoc | 47 +++
...ips-n-tricks_overriding-jdo-annotations.adoc | 5 +
.../user-guide_how-tos_triggering-events.adoc | 136 +++++++
.../user-guide/user-guide_how-tos_ui-hints.adoc | 55 +++
...er-guide_integrating-with-other-systems.adoc | 11 +
.../user-guide/user-guide_isis-addons.adoc | 44 +++
.../user-guide/user-guide_reference.adoc | 25 ++
...-guide_reference_applib-utility-classes.adoc | 144 ++++++++
.../user-guide_reference_cmd-line-args.adoc | 31 ++
...uide_reference_convenience-superclasses.adoc | 8 +
.../user-guide_reference_domain-services.adoc | 8 +
...-guide_reference_recognized-annotations.adoc | 8 +
...nce_recognized-configuration-properties.adoc | 28 ++
...user-guide_reference_recognized-methods.adoc | 8 +
.../user-guide_reference_value-types.adoc | 14 +
.../user-guide_reference_web-xml.adoc | 8 +
.../user-guide/user-guide_restful-viewer.adoc | 35 ++
.../asciidoc/user-guide/user-guide_testing.adoc | 22 ++
...er-guide_testing_bdd-integ-test-support.adoc | 7 +
.../user-guide_testing_fake-data.adoc | 11 +
.../user-guide_testing_fixture-scripts.adoc | 65 ++++
.../user-guide_testing_integ-test-support.adoc | 19 +
.../user-guide_testing_unit-test-support.adoc | 200 ++++++++++
.../user-guide/user-guide_troubleshooting.adoc | 13 +
...ide_troubleshooting_datanucleus-logging.adoc | 10 +
.../user-guide/user-guide_wicket-viewer.adoc | 74 ++++
179 files changed, 2654 insertions(+), 2420 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/Gemfile
----------------------------------------------------------------------
diff --git a/adocs/documentation/Gemfile b/adocs/documentation/Gemfile
new file mode 100644
index 0000000..c20c846
--- /dev/null
+++ b/adocs/documentation/Gemfile
@@ -0,0 +1,13 @@
+source 'https://rubygems.org'
+
+# only compatible with ruby 2.0
+# http://stackoverflow.com/questions/29123339/error-installed-wdm-gem-on-windows-system
+gem 'wdm', '>= 0.1.0' if Gem.win_platform?
+
+
+#https://github.com/guard/listen
+gem 'listen', '~> 2.7' # this prevents upgrading to 3.x
+gem 'asciidoctor'
+
+gem 'tilt'
+gem 'thread_safe'
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/Gemfile.lock
----------------------------------------------------------------------
diff --git a/adocs/documentation/Gemfile.lock b/adocs/documentation/Gemfile.lock
new file mode 100644
index 0000000..b6d2a28
--- /dev/null
+++ b/adocs/documentation/Gemfile.lock
@@ -0,0 +1,30 @@
+GEM
+ remote: https://rubygems.org/
+ specs:
+ asciidoctor (1.5.2)
+ celluloid (0.16.0)
+ timers (~> 4.0.0)
+ ffi (1.9.8-x64-mingw32)
+ hitimes (1.2.2)
+ listen (2.10.0)
+ celluloid (~> 0.16.0)
+ rb-fsevent (>= 0.9.3)
+ rb-inotify (>= 0.9)
+ rb-fsevent (0.9.4)
+ rb-inotify (0.9.5)
+ ffi (>= 0.5.0)
+ thread_safe (0.3.5)
+ tilt (2.0.1)
+ timers (4.0.1)
+ hitimes
+ wdm (0.1.0)
+
+PLATFORMS
+ x64-mingw32
+
+DEPENDENCIES
+ asciidoctor
+ listen (~> 2.7)
+ thread_safe
+ tilt
+ wdm (>= 0.1.0)
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/README.md
----------------------------------------------------------------------
diff --git a/adocs/documentation/README.md b/adocs/documentation/README.md
index 00b381d..cd27474 100644
--- a/adocs/documentation/README.md
+++ b/adocs/documentation/README.md
@@ -39,20 +39,47 @@ Put the following information in your ~/.m2/settings.xml file
</server>
-Build and Review
-----------------
+Instant Preview (optional)
+---------------
-To build the documentation locally, simply use:
+To build
- mvn site
+download ruby 2.0.0
-The site will be generated at `target/site/index.html`.
+* [http://rubyinstaller.org/downloads/](rubyinstaller.org/downloads)
+
+> the wdm gem (required to monitor the filesystem if running on Windows) is not currently compatible with Ruby 2.1.
+
+download and install devkit for the Ruby 2.0 installation:
+
+* [http://rubyinstaller.org/downloads/](rubyinstaller.org/downloads)
+* https://github.com/oneclick/rubyinstaller/wiki/Development-Kit
+
+install:
+
+ gem install bundler
+ bundle install
+
+run:
+
+ ruby listen.rb
To review, recommend running a Python server:
cd target/site
python -m SimpleHTTPServer
+
+
+Build and Review (using Maven)
+-----------------------
+
+To build the documentation locally prior to release, simply use:
+
+ mvn site
+
+The site will be generated at `target/site/index.html`.
+
Then open the browser on [localhost:8000](http://localhost:8000/).
Publish procedure
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/listen.rb
----------------------------------------------------------------------
diff --git a/adocs/documentation/listen.rb b/adocs/documentation/listen.rb
new file mode 100644
index 0000000..20438d8
--- /dev/null
+++ b/adocs/documentation/listen.rb
@@ -0,0 +1,95 @@
+#!/c/bin/Ruby200-x64/bin/ruby -w
+
+require 'rubygems'
+require 'pathname'
+require 'fileutils'
+require 'bundler/setup'
+
+Bundler.require(:default)
+
+
+#https://github.com/guard/listen
+
+$CELLULOID_DEBUG=false
+$CELLULOID_TEST=false
+
+#
+#guard 'shell' do
+# watch(/^.*\.adoc$/) {|m|
+# #Asciidoctor.convert_file(m[0], :in_place => true)
+# puts "Hello, Ruby!";
+# }
+#end
+
+scriptDir = File.absolute_path File.dirname(__FILE__)
+templateDir = File.absolute_path '../template'
+targetDir = File.absolute_path 'target/site'
+workingDir = Dir.pwd
+
+templateDirPath = Pathname.new templateDir
+targetDirPath = Pathname.new targetDir
+workingDirPath = Pathname.new workingDir
+
+listener = Listen.to('src/foo', 'src/bar') do |modified, added, removed|
+ unless modified.length==0
+ modified.each { |file|
+
+ dir = File.dirname file
+ base = File.basename file
+
+ #puts "modified #{file}"
+ #puts "dir: #{dir}"
+ #puts "base: #{base}"
+
+ dirPath = Pathname.new dir
+
+ srcRel = dirPath.relative_path_from workingDirPath
+ #templateRel = dirPath.relative_path_from templateDirPath
+
+ targetRelPath = targetDirPath + srcRel
+ destinationDir = File.absolute_path targetRelPath.to_s
+
+ Dir.chdir(dir)
+
+ #puts "dir: #{dir}"
+ #puts "file: #{file}"
+ #puts "templateDir: #{templateDir}"
+ #puts "destinationDir: #{destinationDir}"
+
+ FileUtils.mkdir_p destinationDir
+
+ #attributes = {:imagesdir => '', :toc => 'right', :icons => 'font', :source-highlighter => 'coderay'}
+
+ #Asciidoctor.convert_file(file, :in_place => true, :backend => 'html', :eruby => 'erb', :template_dir => templateDir, :destination_dir => targetRelDir, :attributes => attributes)
+
+ #Asciidoctor.convert_file(file, :in_place => true, :backend => 'html', :eruby => 'erb', :template_dir => templateDir, :destination_dir => targetRelDir)
+
+ cmd = "asciidoctor #{file} --backend html --eruby erb --template-dir '#{templateDir}' --destination-dir='#{destinationDir}' -a imagesdir='' -a toc=right -a icons=font -a source-highlighter=coderay"
+
+ puts ""
+ puts cmd
+
+#Asciidoctor.convert_file file, :in_place => true, :backend => 'html', :eruby => 'erb', :template_dir => templateDir, :destination_dir => targetRelDir
+
+ system cmd
+
+ Dir.chdir(workingDir)
+ }
+ end
+ unless added.length==0
+ puts "added absolute path: #{added}"
+ added.each { |file|
+ puts "added #{file}"
+
+ }
+ end
+ unless removed.length==0
+ removed.each { |file|
+ puts "removed #{file}"
+
+ }
+ end
+end
+listener.start
+listener.only(/.*\.adoc$/)
+sleep
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 1decbc9..0000000
--- a/adocs/documentation/src/main/asciidoc/getting-started/archetype/simpleapp-archetype.adoc
+++ /dev/null
@@ -1,7 +0,0 @@
-= 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/
-
-IMPORTANT: TODO
-
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 24fbed3..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/010-welcome-page.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 1d0cb46..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/020-choose-location.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 01fbe56..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/030-installation-options.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index dc850cc..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/040-start-menu-folder.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 7b80e17..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/050-completing.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 0054c4c..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/060-import-settings-or-not.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 247fc64..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/010-installing/070-set-ui-theme.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index a950887..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/010-new-project-create.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 16fe8d1..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/020-java-project-setup-jdk.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index d0214c6..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/030-java-project-select-jdk.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index b9399d6..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/040-sdk-selected.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 7f3b8d6..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/050-name-and-location.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 287478a..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/020-create-new-project/060-create-dir.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index c607856..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/010-settings-import-jar.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 8e63a35..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/020-select-all.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index c20e0ac..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/030-import-settings/030-restart.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 9fef693..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/010-maven-installation.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 945968d..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/020-maven-configuration.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index b383b3c..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/030-build-automatically.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 293d2c3..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/040-other-settings/040-auto-import.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 9e2230b..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/010-some-plugins.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 037c967..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/050-some-plugins/020-some-plugins-confirmation.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index a5b8944..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/010-maven-modules-view.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index b8e9ba9..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/020-adding-another-module.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 58b42f0..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/030-other-module-added.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 0421f99..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/040-ignoring-modules.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 6bf26ac..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/050-ignoring-modules-2.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index b16086b..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/100-maven-module-mgmt/060-ignored-modules.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/010-run-configuration.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/010-run-configuration.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/010-run-configuration.png
deleted file mode 100644
index 0c6a929..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/010-run-configuration.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/020-datanucleus-enhancer-goal.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/020-datanucleus-enhancer-goal.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/020-datanucleus-enhancer-goal.png
deleted file mode 100644
index 2dae157..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/020-datanucleus-enhancer-goal.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/030-running-unit-tests.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/030-running-unit-tests.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/030-running-unit-tests.png
deleted file mode 100644
index b4e042a..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/030-running-unit-tests.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/040-running-unit-tests-run-configuration.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/040-running-unit-tests-run-configuration.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/040-running-unit-tests-run-configuration.png
deleted file mode 100644
index 83a4a70..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/040-running-unit-tests-run-configuration.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/050-running-integration-tests-run-configuration.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/050-running-integration-tests-run-configuration.png b/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/050-running-integration-tests-run-configuration.png
deleted file mode 100644
index 6b0ad89..0000000
Binary files a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/images/110-running-the-app/050-running-integration-tests-run-configuration.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/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
deleted file mode 100644
index 06967db..0000000
--- a/adocs/documentation/src/main/asciidoc/getting-started/development-environment/intellij-idea/intellij-idea.adoc
+++ /dev/null
@@ -1,362 +0,0 @@
-= 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
-
-
-
-## Setting up and Configurating IntelliJ
-
-### Download and Install
-
-WARNING: 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 :-)
-
-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, you can think of it as 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 (though these are not critical).
-
-First, specify an up-to-date Maven installation, using `File > Settings` (or `IntelliJ > Preferences` if on MacOS):
-
-.IntelliJ Other Settings - Maven Installation
-image::{_imagesdir}040-other-settings/010-maven-installation.png[width="600px"]
-
-Still on the Maven settings page, configure as follows:
-
-.IntelliJ Other Settings - Maven Configuration
-image::{_imagesdir}040-other-settings/020-maven-configuration.png[width="600px"]
-
-On the compiler settings page, ensure that `build automatically` is enabled (and optionally `compile independent modules in parallel`):
-
-.IntelliJ Other Settings - Compiler Settings
-image::{_imagesdir}040-other-settings/030-build-automatically.png[width="600px"]
-
-On the auto import page, check the `optimize imports on the fly` and `add unambiguous imports on the fly`
-
-.IntelliJ Other Settings - Auto Import
-image::{_imagesdir}040-other-settings/040-auto-import.png[width="600px"]
-
-
-
-### Plugins
-
-You might also want to set up some additional plugins, using `File > Settings > Plugins` (or equivalently `File > Other Settings > Configure Plugins`).
-
-Recommended are:
-* link:https://plugins.jetbrains.com/plugin/7179?pr=idea[Maven Helper] plugin
-+
-Provides better visualization of dependency trees (similar to Eclipse)
-* link:https://github.com/asciidoctor/asciidoctor-intellij-plugin[AsciiDoctor] plugin
-+
-Useful if you are doing any authoring of documents.
-
-Some others you might like to explore are:
-
-.IntelliJ Plugins
-image::{_imagesdir}050-some-plugins/020-some-plugins-confirmation.png[width="400px"]
-
-
-
-
-## Importing and Managing Maven Modules
-
-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 - Ignoring Modules (ctd)
-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 - Updated Projects Window
-image::{_imagesdir}100-maven-module-mgmt/060-ignored-modules.png[width="730px"]
-
-
-
-## Running
-
-Let's see how to run both the app and the tests.
-
-### Running the App
-
-Once you've imported your Isis application, we should run it. We do this by creating a Run configuration, using `Run > Edit Configurations`.
-
-Set up the details as follows:
-
-.IntelliJ Running the App - Run Configuration
-image::{_imagesdir}110-running-the-app/010-run-configuration.png[width="600px"]
-
-We specify the `Main class` to be `org.apache.isis.WebServer`; this is a wrapper around Jetty. It's possible to pass program arguments to this (eg to automatically install fixtures), but for now leave this blank.
-
-Also note that `Use classpath of module` is the webapp module for your app, and that the `working directory` is `$MODULE_DIR$`.
-
-Next, and most importantly, configure the DataNucleus enhancer to run for your `dom` goal. This can be done by defining a Maven goal to run before the app:
-
-.IntelliJ Running the App - Datanucleus Enhancer Goal
-image::{_imagesdir}110-running-the-app/020-datanucleus-enhancer-goal.png[width="400px"]
-
-The `-o` flag in the goal means run off-line; this will run faster.
-
-WARNING: if you forget to set up the enhancer goal, or don't run it on the correct (dom) module, then you will get all sorts of errors when you startup. These usually manifest themselves as class cast exception in DataNucleus.
-
-You should now be able to run the app using `Run > Run Configuration`. The same configuration can also be used to debug the app if you so need.
-
-
-### Running the Unit Tests
-
-The easiest way to run the unit tests is just to right click on the `dom` module in the _Project Window_, and choose run unit tests. Hopefully your tests will pass (!).
-
-.IntelliJ Running the App - Unit Tests Run Configuration
-image::{_imagesdir}110-running-the-app/030-running-unit-tests.png[width="600px"]
-
-As a side-effect, this will create a run configuration, very similar to the one we manually created for the main app:
-
-.IntelliJ Running the App - Unit Tests Run Configuration
-image::{_imagesdir}110-running-the-app/040-running-unit-tests-run-configuration.png[width="600px"]
-
-Thereafter, you should run units by selecting this configuration (if you use the right click approach you'll end up with lots of run configurations, all similar).
-
-### Running the Integration Tests
-
-Integration tests can be run in the same way as unit tests, however the `dom` module must also have been enhanced.
-
-One approach is to initially run the tests use the right click on the `integtests` module; the tests will fail because the code won't have been enhanced, but we can then go and update the run configuration to run the datanucleus enhancer goal (same as when running the application):
-
-.IntelliJ Running the App - Integration Tests Run Configuration
-image::{_imagesdir}110-running-the-app/050-running-integration-tests-run-configuration.png[width="600px"]
-
-
-
-## Hints and Tips
-
-### Keyboard Shortcuts Cheat Sheets
-
-You can download 1-page PDFs cheat sheets for IntelliJ's keyboard shortcuts:
-* for link:https://www.jetbrains.com/idea/docs/IntelliJIDEA_ReferenceCard.pdf[Windows]
-* for MacOS:https://www.jetbrains.com/idea/docs/IntelliJIDEA_ReferenceCard_Mac.pdf[MacOS]
-
-Probably the most important shortcut on them is for `Find Action`:
-- `ctrl-shift-A` on Windows
-- `cmd-shift-A` on MacOS.
-
-This will let you search for any action just by typing its name.
-
-### Switching between Tool Windows and Editors
-
-The Tool Windows are the views around the editor (to left, bottom and right). It's possible to move these around to your preferred locations.
-
-* Use `alt-1` through `alt-9` (or `cmd-1` through `alt-9`) to select the tool windows
-** Press it twice and the tool window will hide itself; so can use to toggle
-* If in the _Project Window_ (say) and hit enter on a file, then it will be shown in the editor, but (conveniently) the focus remains in the tool window. To switch to the editor, just press `Esc`.
-** If in the _Terminal Window_, you'll need to press `Shift-Esc`.
-* If on the editor and want to locate the file in (say) the _Project Window_, use `alt-F1`.
-* To change the size of any tool window, use `ctrl-shift-arrow`
-
-Using these shortcuts you can easily toggle between the tool windows and the editor, without using the mouse. Peachy!
-
-### Navigating Around
-
-For all of the following, you don't need to type every letter, typing "ab" will actually search for ".*a.*b.*".
-
-* to open classes or files or methods that you know the name of:
-** `ctrl-N` to open class
-** `ctrl-shift-N` to open a file
-** (bit fiddly this) `ctrl-shift-alt-N` to search for any symbol.
-* open up dialog of recent files: `ctrl-E`
-* search for any file: `shift-shift`
-
-Navigating around:
-* find callers of a method (the call hierarchy): `ctrl-alt-H`
-* find subclasses or overrides: `ctrl-alt-B`
-* find superclasses/interface/declaration: `ctrl-B`
-
-Viewing the structure (ie outline) of a class
-* `ctrl-F12` will pop-up a dialog showing all members
-** hit `ctrl-F12` again to also see inherited members
-
-
-### Editing
-
-* Extend selection using `ctrl-W`
-** and contract it down again using `ctrl-shift-W`
-* to duplicate a line, it's `ctrl-D`
-** if you have some text selected (or even some lines), it'll actually duplicate the entire selection
-* to delete a line, it's `ctrl-X`
-* to move a line up or down: `shift-alt-up` and `shift-alt-down`
-** if you have selected several lines, it'll move them all togethe
-* `ctrl-shift-J` can be handy for joining lines together
-** just hit enter to split them apart (even in string quotes; IntelliJ will "do the right thing")
-
-### Intentions and Code Completion
-
-Massively useful is the "Intentions" popup; IntelliJ tries to guess what you might want to do. You can activate this using`alt-enter`, whenever you see a lightbulb/tooltip in the margin of the current line.
-
-Code completion usually happens whenever you type '.'. You can also use `ctrl-space` to bring these up.
-
-In certain circumstances (eg in methods0) you can also type `ctrl-shift-space` to get a smart list of methods etc that you might want to call. Can be useful.
-
-Last, when invoking a method, use `ctrl-P` to see the parameter types.
-
-
-### Refactoring
-
-Loads of good stuff on the `Refactor` menu; most used are:
-
-* Rename (`shift-F6`)
-* Extract
-** method: `ctrl-alt-M`
-** variable: `ctrl-alt-V`
-* Inline method/variable: `ctrl-alt-N`
-* Change signature
-
-If you can't remember all those shortcuts, just use `ctrl-shift-alt-T` (might want to rebind that to something else!) and get a context-sensitive list of refactorings available for the currently selected object
-
-
-### Troubleshooting
-
-When a Maven module is imported, IntelliJ generates its own project files (suffix `.ipr`), and the application is actually built from that.
-
-Occasionally these don't keep in sync (even if auto-import of Maven modules has been enabled).
-
-To fix the issue, try:
-* reimport module
-* rebuild selected modules/entire project
-* remove and then re-add the project
-* restart, invalidating caches
-* hit StackOverflow (!)
-
-One thing worth knowing; IntelliJ actively scans the filesystem all the time. It's therefore (almost always) fine to build the app from the Maven command line; IntelliJ will detect the changes and keep in sync. If you want to force that, use `File > Synchronize`, `ctrl-alt-Y`.
-
-
-## Advanced
-
-In this section are a couple of options that will reduce the length of the change code/build/deploy/review feedback loop.
-
-
-### Setting up Dynamic Reloading
-
-IMPORTANT: TODO
-
-### Setting up JRebel
-
-IMPORTANT: TODO
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/010-welcome-page.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/010-welcome-page.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/010-welcome-page.png
new file mode 100644
index 0000000..24fbed3
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/010-welcome-page.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/020-choose-location.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/020-choose-location.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/020-choose-location.png
new file mode 100644
index 0000000..1d0cb46
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/020-choose-location.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/030-installation-options.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/030-installation-options.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/030-installation-options.png
new file mode 100644
index 0000000..01fbe56
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/030-installation-options.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/040-start-menu-folder.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/040-start-menu-folder.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/010-installing/040-start-menu-folder.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/050-completing.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/050-completing.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/050-completing.png
new file mode 100644
index 0000000..7b80e17
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/050-completing.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/060-import-settings-or-not.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/060-import-settings-or-not.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/010-installing/060-import-settings-or-not.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/070-set-ui-theme.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/010-installing/070-set-ui-theme.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/010-installing/070-set-ui-theme.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/010-new-project-create.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/010-new-project-create.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/010-new-project-create.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/020-java-project-setup-jdk.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/020-java-project-setup-jdk.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/020-java-project-setup-jdk.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/030-java-project-select-jdk.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/030-java-project-select-jdk.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/030-java-project-select-jdk.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/040-sdk-selected.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/040-sdk-selected.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/040-sdk-selected.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/050-name-and-location.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/050-name-and-location.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/050-name-and-location.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/060-create-dir.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/060-create-dir.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/020-create-new-project/060-create-dir.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/010-settings-import-jar.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/010-settings-import-jar.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/010-settings-import-jar.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/020-select-all.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/020-select-all.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/020-select-all.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/030-restart.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/030-restart.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/030-restart.png
new file mode 100644
index 0000000..c20e0ac
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/030-import-settings/030-restart.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/010-maven-installation.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/010-maven-installation.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/010-maven-installation.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/020-maven-configuration.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/020-maven-configuration.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/020-maven-configuration.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/030-build-automatically.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/030-build-automatically.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/030-build-automatically.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/040-auto-import.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/040-auto-import.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/040-other-settings/040-auto-import.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/050-some-plugins/010-some-plugins.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/050-some-plugins/010-some-plugins.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/050-some-plugins/010-some-plugins.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/010-maven-modules-view.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/010-maven-modules-view.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/010-maven-modules-view.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/020-adding-another-module.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/020-adding-another-module.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/020-adding-another-module.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/030-other-module-added.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/030-other-module-added.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/030-other-module-added.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/040-ignoring-modules.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/040-ignoring-modules.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/040-ignoring-modules.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/050-ignoring-modules-2.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/050-ignoring-modules-2.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/050-ignoring-modules-2.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/060-ignored-modules.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/060-ignored-modules.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/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/user-guide/images/appendices/dev-env/intellij-idea/100-maven-module-mgmt/060-ignored-modules.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/010-run-configuration.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/010-run-configuration.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/010-run-configuration.png
new file mode 100644
index 0000000..0c6a929
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/010-run-configuration.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/020-datanucleus-enhancer-goal.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/020-datanucleus-enhancer-goal.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/020-datanucleus-enhancer-goal.png
new file mode 100644
index 0000000..2dae157
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/020-datanucleus-enhancer-goal.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/030-running-unit-tests.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/030-running-unit-tests.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/030-running-unit-tests.png
new file mode 100644
index 0000000..b4e042a
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/030-running-unit-tests.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/040-running-unit-tests-run-configuration.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/040-running-unit-tests-run-configuration.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/040-running-unit-tests-run-configuration.png
new file mode 100644
index 0000000..83a4a70
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/040-running-unit-tests-run-configuration.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/050-running-integration-tests-run-configuration.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/050-running-integration-tests-run-configuration.png b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/050-running-integration-tests-run-configuration.png
new file mode 100644
index 0000000..6b0ad89
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/appendices/dev-env/intellij-idea/110-running-the-app/050-running-integration-tests-run-configuration.png differ
http://git-wip-us.apache.org/repos/asf/isis/blob/90f26cf6/adocs/documentation/src/main/asciidoc/user-guide/images/how-tos/tips-n-tricks/are-you-sure-happy-case.png
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/images/how-tos/tips-n-tricks/are-you-sure-happy-case.png b/adocs/documentation/src/main/asciidoc/user-guide/images/how-tos/tips-n-tricks/are-you-sure-happy-case.png
new file mode 100644
index 0000000..1981c09
Binary files /dev/null and b/adocs/documentation/src/main/asciidoc/user-guide/images/how-tos/tips-n-tricks/are-you-sure-happy-case.png differ