Merge pull request circleci#2308 from circleci/deploy-link-and-tocs-for-lang-guides

Deploy link and tocs for lang guides

Author: michelle-luna

jekyll/_cci2/language-android.md

@@ -11,6 +11,9 @@ order: 9
 
 This guide will help you get started with an Android application on CircleCI.
 
+* TOC
+{:toc}
+
 ## Overview
 
 There are some assumptions made in this guide:
@@ -55,6 +58,7 @@ jobs:
           destination: reports
       - store_test_results:
           path: app/build/test-results
+      # See https://circleci.com/docs/2.0/deployment-integrations/ for deploy examples    
 
 ```
 {% endraw %}
@@ -126,3 +130,7 @@ React Native projects can be built on CircleCI 2.0 using Linux, Android
 and macOS capabilities. Please check out [this example React Native
 application](https://github.com/CircleCI-Public/circleci-demo-react-native)
 on GitHub for a full example of a React Native project.
+
+## Deploy
+
+See the [Deploy]({{ site.baseurl }}/2.0/deployment-integrations/) document for example deploy target configurations.

jekyll/_cci2/language-clojure.md

@@ -11,6 +11,9 @@ order: 2
 
 This guide will help you get started with a Clojure application on CircleCI 2.0. If you’re in a rush, just copy the sample configuration below into a `.circleci/config.yml` in your project’s root directory and start building.
 
+* TOC
+{:toc}
+
 ## Overview
 
 Otherwise, we recommend reading our [walkthrough](#config-walkthrough) for a detailed explanation of our configuration.
@@ -26,28 +29,29 @@ If you use another testing tool, you can just adjust that step to run a differen
 
 {% raw %}
 ```YAML
-version: 2
-jobs:
-  build:
-    working_directory: ~/cci-demo-clojure
-    docker:
-      - image: circleci/clojure:lein-2.7.1
-    environment:
+version: 2 # use CircleCI 2.0
+jobs: # basic units of work in a run
+  build: # runs not using Workflows must have a `build` job as entry point
+    working_directory: ~/cci-demo-clojure # directory where steps will run
+    docker: # run the steps with Docker
+      - image: circleci/clojure:lein-2.7.1 # ...with this image as the primary container; this is where all `steps` will run
+    environment: # environment variables for primary container
       LEIN_ROOT: nbd
-      JVM_OPTS: -Xmx3200m
-    steps:
-      - checkout
-      - restore_cache:
+      JVM_OPTS: -Xmx3200m # limit the maximum heap size to prevent out of memory errors
+    steps: # commands that comprise the `build` job
+      - checkout # check out source code to working directory
+      - restore_cache: # restores saved cache if checksum hasn't changed since the last run
           key: cci-demo-clojure-{{ checksum "project.clj" }}
       - run: lein deps
-      - save_cache:
+      - save_cache: # generate and store cache in the .m2 directory using a key template
           paths:
             - ~/.m2
           key: cci-demo-clojure-{{ checksum "project.clj" }}
       - run: lein do test, uberjar
-      - store_artifacts:
+      - store_artifacts: # upload test results for display in Test Summary
           path: target/uberjar/cci-demo-clojure.jar
           destination: uberjar
+      # See https://circleci.com/docs/2.0/deployment-integrations/ for deploy examples     
 ```
 {% endraw %}
 
@@ -133,6 +137,10 @@ Finally we store the uberjar as an [artifact](https://circleci.com/docs/1.0/buil
 
 Nice! You just set up CircleCI for a Clojure app.
 
+## Deploy
+
+See the [Deploy]({{ site.baseurl }}/2.0/deployment-integrations/) document for example deploy target configurations.
+
 ## Detailed Examples
 
 This app illustrates the simplest possible setup for a Clojure web app. Real world projects tend to be more complex, so you may find this more detailed example useful as you configure your own projects:

jekyll/_cci2/language-go.md

@@ -12,6 +12,9 @@ order: 3
 
 **CircleCI 2.0 supports building Go projects using any version of Go that can be installed in a Docker image.**
 
+* TOC
+{:toc}
+
 ## New to CircleCI 2.0?
 
 If you're new to CircleCI 2.0, we recommend reading our [walkthrough](#config-walkthrough) for a detailed explanation of our configuration.
@@ -192,4 +195,9 @@ Finally, let's specify a path to store the results of the tests.
 
 Success! You just set up CircleCI 2.0 for a Go app. Check out our {% comment %} TODO: Jobs {% endcomment %} [project’s build page](https://circleci.com/gh/CircleCI-Public/circleci-demo-go) to see how this looks when building on CircleCI.
 
-If you have any questions about the specifics of testing your Go application, head over to our [community forum](https://discuss.circleci.com/) for support from us and other users.
+## Deploy
+
+## Deploy
+
+See the [Deploy]({{ site.baseurl }}/2.0/deployment-integrations/) document for example deploy target configurations.
+

jekyll/_cci2/language-java.md

@@ -11,6 +11,9 @@ order: 4
 
 This guide will help you get started with a Java application on CircleCI. 
 
+* TOC
+{:toc}
+
 ## Overview
 
 If you’re in a rush, just copy the sample configuration below into a `.circleci/config.yml` in your project’s root directory and start building.
@@ -57,6 +60,7 @@ jobs: # a collection of steps
 
       - store_artifacts: # store the uberjar as an artifact
           path: target/demo-java-spring-0.0.1-SNAPSHOT.jar
+      # See https://circleci.com/docs/2.0/deployment-integrations/ for deploy examples    
 ```
 {% endraw %}
 
@@ -141,5 +145,9 @@ Finally we store the uberjar as an [artifact](https://circleci.com/docs/2.0/arti
 
 Nice! You just set up CircleCI for a Java app using Maven and Spring.
 
+## Deploy
+
+See the [Deploy]({{ site.baseurl }}/2.0/deployment-integrations/) document for example deploy target configurations.
+
 
 

jekyll/_cci2/language-javascript.md

@@ -11,6 +11,9 @@ order: 5
 
 If you're new to CircleCI 2.0, we recommend reading our [Project Walkthrough]({{ site.baseurl }}/2.0/project-walkthrough/) for a detailed explanation of our configuration using Python and Flask as an example.
 
+* TOC
+{:toc}
+
 ## Quickstart: demo JavaScript NodeJS reference project
 
 We maintain a reference JavaScript NodeJS project to show how to build an Express.js app on CircleCI 2.0:
@@ -75,12 +78,17 @@ jobs: # a collection of steps
           prefix: coverage
       - store_test_results: # special step to upload test results for display in Test Summary
           path: test-results.xml
+      # See https://circleci.com/docs/2.0/deployment-integrations/ for deploy examples    
 ```          
 {% endraw %}          
 ---
 
 Success! You just set up CircleCI 2.0 for a NodeJS app. Check out our [project’s {% comment %} TODO: Job {% endcomment %}build page](https://circleci.com/gh/CircleCI-Public/circleci-demo-javascript-express) to see how this looks when building on CircleCI.
 
+## Deploy
+
+See the [Deploy]({{ site.baseurl }}/2.0/deployment-integrations/) document for example deploy target configurations.
+
 ## See Also
 
 Refer to the [Examples]({{ site.baseurl }}/2.0/examples/) page for more configuration examples of public Javascript projects.

jekyll/_cci2/language-php.md

@@ -11,6 +11,9 @@ order: 6
 
 If you're new to CircleCI 2.0, we recommend reading our [Project Walkthrough]({{ site.baseurl }}/2.0/project-walkthrough/) for a detailed explanation of our configuration using Python and Flask as an example.
 
+* TOC
+{:toc}
+
 ## Quickstart: Demo PHP Laravel reference project
 
 We maintain a reference PHP Laravel project to show how to build PHP on CircleCI 2.0:
@@ -76,13 +79,18 @@ jobs: # a collection of steps
       - run: php artisan migrate --env=testing --database=sqlite_testing --force
       - run: ./vendor/bin/codecept build
       - run: ./vendor/bin/codecept run
+      # See https://circleci.com/docs/2.0/deployment-integrations/ for deploy examples    
 ```
 {% endraw %}
 
 ---
 
 Success! You just set up CircleCI 2.0 for a PHP app. Check out our {% comment %} TODO: Job {% endcomment %} [project’s build page](https://circleci.com/gh/CircleCI-Public/circleci-demo-php-laravel) to see how this looks when building on CircleCI.
 
+## Deploy
+
+See the [Deploy]({{ site.baseurl }}/2.0/deployment-integrations/) document for example deploy target configurations.
+
 ## See Also
 
 Refer to the [Examples]({{ site.baseurl }}/2.0/examples/) page for more configuration examples of public PHP projects.

jekyll/_cci2/language-python.md

@@ -11,6 +11,9 @@ order: 7
 
 This document describes CircleCI configuration for a sample application written in Python. 
 
+* TOC
+{:toc}
+
 ## Demo Python Django Reference Project
 
 We maintain a reference Python Django project to show how to build Django on CircleCI 2.0:
@@ -85,9 +88,15 @@ Finally, add several `steps` within the `build` job:
       - store_artifacts: # special step to store test reports as artifacts
           path: test-reports/
           destination: tr1
+      # See https://circleci.com/docs/2.0/deployment-integrations/ for deploy examples    
 ```
 {% endraw %}
 
 Refer to the [configuration reference]({{ site.baseurl }}/2.0/configuration-reference/) for the complete list of available CircleCI configuration keys.
 
+## Deploy
+
+See the [Deploy]({{ site.baseurl }}/2.0/deployment-integrations/) document for example deploy target configurations.
+
+
 

jekyll/_cci2/language-ruby.md

@@ -11,6 +11,9 @@ order: 8
 
 This guide will help you get started with a Ruby on Rails application on CircleCI. 
 
+* TOC
+{:toc}
+
 ## Overview
 
 If you’re in a rush, just copy the sample configuration below into a `.circleci/config.yml` in your project’s root directory and start building.