[Suggestion] Merge guide/dev into website/developers

guide/misc/index.md

@@ -9,7 +9,7 @@ children:
 - release-notes.md
 - migrate-to-0.8.0.md
 - known-issues.md
-- { path: ../dev/, title_in_menu: "Developer Guide" }
+- { path: /website/developers/, title_in_menu: "Developer Guide" }
 - { path: /website/documentation/, title_in_menu: "All Documentation", menu_customization: { force_inactive: true } }
 ---
 

guide/ops/osgi.md

@@ -65,6 +65,8 @@ JAVA_DEBUG_OPTS='-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5
 For other options please check your JVM JPDA documentation.
 Hotspot JPDA:  https://docs.oracle.com/javase/8/docs/technotes/guides/jpda/
 
+## Quick testing
+
 ## Configuring
 
 Configuration of Brooklyn when running under Karaf is largely done through standard Karaf mechanisms.

website/developers/index.md

@@ -1,14 +1,21 @@
 ---
 layout: website-normal
 title: Developers
-started-pdf-exclude: true
+menu_parent: index.md
 children:
 - code/
 - how-to-contribute.md
-- /guide/dev/
 - committers/
 - code-standards.md
 - links.md
+- env/maven-build.md
+- env/ide/
+- code/
+- tips/
+- tips/logging.md
+- tips/debugging-remote-brooklyn.md
+- { link: "http://github.com/apache/brooklyn", title: "GitHub" }
+- { link: "https://brooklyn.apache.org/v/latest/misc/javadoc", title: "Javadoc" }
 - { link: 'http://github.com/apache/brooklyn', title: 'GitHub' }
 - { link: 'https://issues.apache.org/jira/browse/BROOKLYN', title: 'Bug Tracker (JIRA)' }
 ---
@@ -24,15 +31,15 @@ working with the bleeding edge Brooklyn code.
 <div class="panel-body" markdown="1">
 As these pages contain information about accessing the bleeding edge code and artifacts produced from it,
 you should be aware that the code and binaries you will encounter may be unstable.
-The Apache Software Foundation has not performed the level of validation and due diligence done 
-on formally released artifacts. 
+The Apache Software Foundation has not performed the level of validation and due diligence done
+on formally released artifacts.
 Proceed only if you understand the potential consequences of using unreleased code
 and are comfortable doing so.
 </div>
 </div>
 
 We heartily welome contributions and new members.
-There's nothing official needed to get involved; 
+There's nothing official needed to get involved;
 simply come say hello somewhere in the [community](../community/index.html):
 
 - [Mailing lists](../community/mailing-lists.html)
@@ -41,10 +48,30 @@ simply come say hello somewhere in the [community](../community/index.html):
 
 Then [get the code](code/).
 
-When you have a blueprint or an improvement you want to share, 
+When you have a blueprint or an improvement you want to share,
 there are a few instructions to note on [how to contribute](how-to-contribute.html).
 
-If you're looking to learn more about the codebase itself, 
-have a look at [Developer Guide]({{ site.path.guide }}/dev/).
 There are also a number of [development bookmarks](links.html) for the tools we use
 (git, jenkins, jira).
+
+
+{% comment %}
+TODO
+
+The Developer Guide contains information on working with the Brooklyn codebase.
+
+Of particular note to people getting started, there is:
+
+* Help with Maven
+* Help with Git
+* Help setting up IDE's
+
+And for the Brooklyn codebase itself, see:
+
+* Project structure
+* Areas of Special Hairiness
+
+(All links are TODO.)
+{% endcomment %}
+
+{% include list-children.html %}

website/documentation/index.md

@@ -4,7 +4,6 @@ title: Documentation
 started-pdf-exclude: true
 children:
 - /guide/
-- /guide/dev/
 - ../meta/versions.md
 - other-docs.md
 ---

website/index.md

@@ -12,7 +12,6 @@ children:
   - { path: /guide/locations/index.md, title_in_menu: Deploying Blueprints }
   - { path: /guide/ops/index.md, title_in_menu: Reference Guide,
       menu_customization: { dropdown_section_header: true } }
-  - { path: /guide/dev/index.md, title_in_menu: Developer Guide }
   - { path: meta/versions.md, title_in_menu: Versions,
       menu_customization: { dropdown_new_section: true } }
   - { path: documentation/other-docs.md, title_in_menu: Other Resources }