diff --git a/isis/cmake/BuildDocs.cmake b/isis/cmake/BuildDocs.cmake index 139dd93a29..bae6bcc423 100644 --- a/isis/cmake/BuildDocs.cmake +++ b/isis/cmake/BuildDocs.cmake @@ -67,7 +67,7 @@ endfunction(copy_app_docs_info) function(build_upper_level) # Make new (empty) output folders - set(newFolders UserDocs UserStart UserLearn UserExplore UserInspire AboutIsis General Guides Installation TechnicalInfo) + set(newFolders UserDocs UserStart UserLearn UserExplore UserInspire DevStart DevExplore DevInspire AboutIsis General Guides Installation TechnicalInfo) foreach(f ${newFolders}) file(MAKE_DIRECTORY "${docInstallFolder}/${docVersion}/${f}") endforeach() @@ -205,6 +205,15 @@ function(build_documents_folder) # USER GET INSPIRED DOCS TOC execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/UserInspire/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/UserInspire.xsl) + # USER GET INSPIRED DOCS TOC + execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/DevStart/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/DevStart.xsl) + + # USER GET INSPIRED DOCS TOC + execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/DevExplore/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/DevExplore.xsl) + + # USER GET INSPIRED DOCS TOC + execute_process(COMMAND ${XALAN} ${XALAN_PARAM_OPTION} menuPath \"../\" ${XALAN_OUTFILE_OPTION} ${docInstallFolder}/${docVersion}/DevInspire/index.html ${XALAN_INFILE_OPTION} ${doctocPath} ${XALAN_XSL_OPTION} ${docBuildFolder}/build/DevInspire.xsl) + endfunction(build_documents_folder) diff --git a/isis/src/docsys/build/DevExplore.xsl b/isis/src/docsys/build/DevExplore.xsl new file mode 100644 index 0000000000..d1a4538a3c --- /dev/null +++ b/isis/src/docsys/build/DevExplore.xsl @@ -0,0 +1,333 @@ + + + + + + + + + + + + + + + + + + + + + + + + + USGS Isis: Getting Started Contributor Documentation + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ +
+ + + USGS
+ + +

+ ISIS Documentation

+ +
+ + + + + + + +
+

+ Contributor Explore in Detail +

+

+ Creating and maintaining quality tools is not simple. ISIS contributors have + worked hard to create accurate references and guides to support future + contributions. If you encounter a specific case that could help future + contributors, feel free to submit documentation for this page. +

+

+ On this page you will find detailed references and specialized guides for contributing to ISIS. +

+

+

+
+ Home +
+ + + +
+

ISIS API Reference

+

+ The ISIS API reference is particularly useful if you are working on an application + or interested in using the ISIS library as a dependency. +

+ + + + + + + + + + + + + + + + + + + +
+ + astrodiscuss + + Ask or answer questions on out community discussion board. +
+ + GitHub Issues + + Comment on bug reports or feature requests from other users. +
+ + Requests for Comment + + Provide feedback on major changes proposed for ISIS. +
+ + ISIS Technical Committee + + Get involved in project governance. +
+ + + +
+

XML Schemas

+

+ The interface for ISIS applications and much of the ISIS documentation (including this + very page) are generated from XML files. These schemas are a helpful reference if you + are creating a new application, modifying application arguments, or writing documentation. +

+ + + + + + + + + + + + + + + + + + + +
+ + Downloading the Source Code + + How to pull the source code from GitHub. +
+ + Dependency Management + + How to download the dependencies required to build ISIS. +
+ + Building + + How to build ISIS once you have the source code and dependencies downloaded. +
+ + Running the Test Suite + + How to run the ISIS test suite once ISIS is built. +
+ + + +
+

Documentation Guides

+

+ If you're not familiar with working on the ISIS documentation, + these guides can help get you started. +

+ + + + + + + + + + + +
+ + Basic ISIS3 Programming + + hese exercises will walk you through the basics of ISIS applications. +
+ + Advanced ISIS Programming Exercises + + These exercises give you the chance to explore more yourself and interact with more + complex components of the ISIS API. +
+ + + +
+

Testing Guides

+

+ Testing is a crucial component of creating sustainable software and a requirement for all + code contributions to ISIS. These guides will help you run and modify the ISIS test suite. +

+ + + + + + + + + + + +
+ + Adding a New Feature + + This document will walk you through what's needed when adding a new feature to ISIS. + If there is something you think is missing in ISIS this will walk you through the + steps needed to add it. +
+ + Modifying an Existing Feature + + Modifying an existing feature is slightly more complex than adding a new feature to ISIS. + This document will walk you through what is different when you are building from an + existing feature instead of something new. +
+ + + +
+

Maintainer Guides

+

+ These resources are useful for maintainers and outline the processes that + support the broader user and contributor community. +

+ + + + + + + + + + + +
+ + Adding a New Feature + + This document will walk you through what's needed when adding a new feature to ISIS. + If there is something you think is missing in ISIS this will walk you through the + steps needed to add it. +
+ + Modifying an Existing Feature + + Modifying an existing feature is slightly more complex than adding a new feature to ISIS. + This document will walk you through what is different when you are building from an + existing feature instead of something new. +
+ + + + +
+ + + + + +
+ + +
diff --git a/isis/src/docsys/build/DevInspire.xsl b/isis/src/docsys/build/DevInspire.xsl new file mode 100644 index 0000000000..e9a183a390 --- /dev/null +++ b/isis/src/docsys/build/DevInspire.xsl @@ -0,0 +1,233 @@ + + + + + + + + + + + + + + + + + + + + + + + + + USGS Isis: Getting Started Contributor Documentation + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ +
+ + + USGS
+ + +

+ ISIS Documentation

+ +
+ + + + + + + +
+

+ Contributor Get Inspired +

+

+ Now that you've got all the resources you need to contribute, + you may be asking "what should I contribute?" +

+

+ On this page you will find resources that will inspire you and give you + some ideas about what other users are interested in too. +

+

+

+
+ Home +
+ + + +
+

GitHub Issues

+

+ The first step for all code contributions to ISIS is a GitHub issue. Look at the open + enhancement requests to see what other members of the community have asked for and maybe + there will be something you are interested in too. It you just want to get started with + contributing code; issues labeled with Good First Issue are an excellent place for + newcomers to start. +

+ + + + + + + + + + + + + + + + + + + +
+ + astrodiscuss + + Ask or answer questions on out community discussion board. +
+ + GitHub Issues + + Comment on bug reports or feature requests from other users. +
+ + Requests for Comment + + Provide feedback on major changes proposed for ISIS. +
+ + ISIS Technical Committee + + Get involved in project governance. +
+ + + +
+

GitHub Pull Requests

+

+ If you are interested in what other contributors are working on, look at the GitHub + pull requests that are currently open. Even if you do not have write permissions to the + repository, input and testing on pull requests are always appreciated. +

+ + + + + + + + + + + + + + + + + + + +
+ + Downloading the Source Code + + How to pull the source code from GitHub. +
+ + Dependency Management + + How to download the dependencies required to build ISIS. +
+ + Building + + How to build ISIS once you have the source code and dependencies downloaded. +
+ + Running the Test Suite + + How to run the ISIS test suite once ISIS is built. +
+ + + + +
+ + + + + +
+ + +
diff --git a/isis/src/docsys/build/DevStart.xsl b/isis/src/docsys/build/DevStart.xsl new file mode 100644 index 0000000000..69161a8ef3 --- /dev/null +++ b/isis/src/docsys/build/DevStart.xsl @@ -0,0 +1,299 @@ + + + + + + + + + + + + + + + + + + + + + + + + + USGS Isis: Getting Started Contributor Documentation + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ +
+ + + USGS
+ + +

+ ISIS Documentation

+ +
+ + + + + + + +
+

+ Contributor Getting Started +

+

+ As Free and Open Source Software (FOSS), everyone is welcome to contribute to ISIS. + We define our contributors as the members of the community that help improve the + software. Community members can contribute by reporting a bug, writing + documentation, validating the software, working on features, and many other ways. + You do not need to write code to contribute! +

+

+ On this page you will find resources to help you improve ISIS and give back to the ISIS community. +

+

+

+
+ Home +
+ + + +
+

Start Contributing

+

+ The quickest way to contribute to ISIS is to contribute to the community. + There are many ways you can support the community without writing any code at all. +

+ + + + + + + + + + + + + + + + + + + +
+ + astrodiscuss + + Ask or answer questions on our community discussion board. +
+ + GitHub Issues + + Comment on bug reports or feature requests from other users. +
+ + Requests for Comment + + Provide feedback on major changes proposed for ISIS. +
+ + ISIS Technical Committee + + Get involved in project governance. +
+ + + +
+

Building ISIS

+

+ If you want to contribute code to ISIS, the first step is getting the ISIS source code + compiling on your system. This document will take you through all the steps required to + compile, test, and optionally install, ISIS. +

+ + + + + + + + + + + + + + + + + + + +
+ + Downloading the Source Code + + How to pull the source code from GitHub. +
+ + Dependency Management + + How to download the dependencies required to build ISIS. +
+ + Building + + How to build ISIS once you have the source code and dependencies downloaded. +
+ + Running the Test Suite + + How to run the ISIS test suite once ISIS is built. +
+ + + +
+

Introductory Exercises

+

+ Now that you can compile the ISIS source code, follow along with these exercises + to learn about programming in ISIS. +

+ + + + + + + + + + + +
+ + Basic ISIS3 Programming + + These exercises will walk you through the basics of ISIS applications. +
+ + Advanced ISIS Programming Exercises + + These exercises give you the chance to explore more yourself and interact with more + complex components of the ISIS API. +
+ + + +
+

Contributing Features

+

+ Once you know what code you want to contribute, these guides will help you get started + with the process and what is required for different types of code contributions. +

+ + + + + + + + + + + +
+ + Adding a New Feature + + This document will walk you through what's needed when adding a new feature to ISIS. + If there is something you think is missing in ISIS this will walk you through the + steps needed to add it. +
+ + Modifying an Existing Feature + + Modifying an existing feature is slightly more complex than adding a new feature to ISIS. + This document will walk you through what is different when you are building from an + existing feature instead of something new. +
+ + + + +
+ + + + + +
+ + +
diff --git a/isis/src/docsys/build/homepage.xml b/isis/src/docsys/build/homepage.xml index 1f86ce9379..da2b23399d 100644 --- a/isis/src/docsys/build/homepage.xml +++ b/isis/src/docsys/build/homepage.xml @@ -141,7 +141,7 @@ -

Getting Started

+

Getting Started

-

Explore in Detail

+

Explore in Detail

-

Get Inspired

+

Get Inspired