Reorder Template sections

- Moves templates under a Templates header to the right-hand nav is
cleared
- Moves PHP7 into the numbered list of templates (we should probably
dump the numbering)
- Moves the ARM/RPi section out of the templates section

Signed-off-by: John McCabe <[email protected]>

Author: johnmccabe

docs/cli/templates.md

@@ -1,5 +1,7 @@
 # Create new functions
 
+## Templates
+
 The OpenFaaS CLI has a template engine built-in which can create new functions in a given programming language. The way this works is by reading a list of templates from the `./template` location in your current working folder.
 
 Before creating a new function make sure you pull in the official OpenFaaS language templates from GitHub via the [templates repository](https://github.com/openfaas/templates).
@@ -10,7 +12,7 @@ $ faas-cli template pull
 
 This page shows how to generate functions in the most popular languages and explains how you can manage their dependencies too.
 
-## 1.0 Go
+### 1.0 Go
 
 To create a new function named `go-fn` in Go type in the following:
 
@@ -28,7 +30,7 @@ go-fn.yml
 
 You can now edit `handler.go` and use the `faas-cli` to `build` and `deploy` your function.
 
-### 1.1 Go: dependencies
+#### 1.1 Go: dependencies
 
 Dependencies should be managed with a Go vendoring tool such as dep.
 
@@ -56,7 +58,7 @@ $ dep ensure -add github.com/cnf/structhash
 
 You can now edit your function and add an import statement in `handler.go` to `github.com/cnf/structhash`.
 
-## 2.0 Python 3
+### 2.0 Python 3
 
 To create a Python function named `pycon` type in:
 
@@ -74,13 +76,13 @@ pycon/requirements.txt
 
 > Note: Python 2.7 is also available with the language template `python`.
 
-### 2.1 Python: dependencies
+#### 2.1 Python: dependencies
 
 You should edit `pycon/requirements.txt` and add any pip modules you want with each one on a new line, for instance `requests`.
 
 The primary Python template uses Alpine Linux as a runtime environment due to its minimal size, but if you need a Debian environment so that you can compile `numpy` or other modules then read on to the next section.
 
-### 2.2 Python: advanced dependencies
+#### 2.2 Python: advanced dependencies
 
 If you need to use pip modules that require compilation then you should try the python3-debian template then add your pip modules to the `requirements.txt` file.
 
@@ -101,7 +103,7 @@ Successfully installed numpy-1.14.2
 ...
 ```
 
-## 3.0 Node.js
+### 3.0 Node.js
 
 Generate a function named `js-fn`:
 
@@ -118,7 +120,7 @@ You'll see:
 ./js-fn/package.json
 ```
 
-### 3.1 Node.js dependencies
+#### 3.1 Node.js dependencies
 
 Node.js dependencies are managed with `npm` and the `package.json` file which was generated for you.
 
@@ -131,7 +133,7 @@ npm i --save cheerio
 
 You can now add a `require('cheerio')` statement into your function and make use of this library.
 
-## 4.0 CSharp / .NET Core 2.1
+### 4.0 CSharp / .NET Core 2.1
 
 You can create functions in .NET Core 2.1 using C# / CSharp.
 
@@ -143,7 +145,7 @@ faas-cli new --lang csharp csharp-function
 
 Now you can open your current folder in a tool such as Visual Studio Code and add dependencies using the project (csproj) file.
 
-## 5.0 Ruby
+### 5.0 Ruby
 
 
 Create a function called `ruby-function`:
@@ -163,7 +165,7 @@ The directory structure is:
 
 Your code should be in the handler.rb file
 
-### 5.1 Adding a Gem (Library)
+#### 5.1 Adding a Gem (Library)
 
 Open the `Gemfile` in the ruby-function directory
 
@@ -173,7 +175,7 @@ Add the following line
 gem 'httparty'
 ```
 
-### 5.1 Using our Gem
+#### 5.1 Using our Gem
 
 Replace your `handler.rb` code with the following
 
@@ -187,7 +189,7 @@ class Handler
 end
 ```
 
-### 5.3 Building / Deploy / Run
+#### 5.3 Building / Deploy / Run
 
 Edit the `ruby-function.yml` and point your image to your dockerhub, for example
 `${your_user}/ruby-function`
@@ -207,7 +209,7 @@ When you HTTParty, you must party hard!
 ...
 ```
 
-### 5.4 Invoke!
+#### 5.4 Invoke!
 
 ```
 $ echo 'OpenFaaS' | faas-cli invoke ruby-function
@@ -226,7 +228,7 @@ $ echo 'OpenFaaS' | faas-cli invoke ruby-function
 ```
 
 
-## 6.0 Java
+### 6.0 Java
 
 A Java 8 template is provided which uses Gradle 4.8.1 as a build-system.
 
@@ -257,13 +259,42 @@ You can use `getHeader(k)` on the Request interface to query a header.
 
 To set a header such as content-type you can use `setHeader(k, v)` on the Response interface.
 
-## 7.0 Customise a template
+### 7.0 PHP 7
+
+To create a PHP7 function named `my-function` type in:
+
+    $ faas-cli new my-function --lang php7
+
+You'll see:
+
+    my-function.yml
+    my-function/src/Handler.php
+    my-function/composer.json
+    my-function/php-extension.sh
+
+Add any dependencies/extensions as described below and implement your functions business logic in `Handler.php`.
+
+#### 7.1 Composer Dependencies
+
+You should edit `composer.json` and add any required package dependencies, referring to the [Composer Documentation](https://getcomposer.org/doc/) for instructions on using `composer.json`.
+
+#### 7.2 Private Composer Repositories
+
+Refer to the [PHP7 Template Documentation](https://github.com/openfaas/templates/tree/master/template/php7) for instructions on how to use [Composers]((https://getcomposer.org/doc/)) `COMPOSER_AUTH` environment variable to configure access to dependencies in private repositories.
+
+#### 7.3 PHP Extensions
+
+The PHP7 template is based upon the [Docker Library PHP image](https://hub.docker.com/_/php/) and provides the `php-extension.sh` script which exposes the ability to customise extensions installed in a function image.
+
+Refer to the [PHP7 Template Documentation](https://github.com/openfaas/templates/tree/master/template/php7) for instructions on customising installed extensions.
+
+### 8.0 Customise a template
 
 It is recommended that you use the official templates as they are provided and if there is a short-coming that you raise a GitHub issue so we can improve the templates for everyone.
 
 All templates are driven by a Dockerfile and can be customised by editing the files found in the ./template folder.
 
-### 7.1 Update the Dockerfile
+#### 8.1 Update the Dockerfile
 
 There are several reasons why you may want to update your Dockerfile, just edit `./template/<language_name>/Dockerfile`.
 
@@ -273,7 +304,7 @@ There are several reasons why you may want to update your Dockerfile, just edit
 
 * Try a new version of a base-image - it may be that the project is showing support for Node.js LTS, but you want the cutting-edge version, you can do that too
 
-### 7.2 Update a template's configuration
+#### 8.2 Update a template's configuration
 
 The name of a template is read from a "template.yml" file kept within the template folder: `./template/<language_name>/template.yml`
 
@@ -287,13 +318,13 @@ fprocess: dotnet ./root.dll
 * `language` is the display name used for `faas-cli new --list`.
 * `fprocess` provides the process to run for each invocation - i.e. your function
 
-### 7.3 Use your own templates
+#### 8.3 Use your own templates
 
 You can use your own Git repository for a custom or forked set of templates. This can be public or private.
 
 See `faas-cli template pull` for more information.
 
-## 8.0 ARM / Raspberry Pi
+## ARM / Raspberry Pi
 
 Templates for ARM and Raspberry Pi are provided on a best-effort basis. If you can help with maintenance please let the project contributors know.
 
@@ -305,33 +336,4 @@ Type in `faas-cli new --list` and look for any languages ending in `-armhf`. You
 
 For these platforms do the same as above and look for the `-arm64` suffix.
 
-> It is easy to make your own templates so if you need to use this platform please convert one of the "regular" templates for your platform.
-
-## 9.0 PHP 7
-
-To create a PHP7 function named `my-function` type in:
-
-    $ faas-cli new my-function --lang php7
-
-You'll see:
-
-    my-function.yml
-    my-function/src/Handler.php
-    my-function/composer.json
-    my-function/php-extension.sh
-
-Add any dependencies/extensions as described below and implement your functions business logic in `Handler.php`.
-
-### 9.1 Composer Dependencies
-
-You should edit `composer.json` and add any required package dependencies, referring to the [Composer Documentation](https://getcomposer.org/doc/) for instructions on using `composer.json`.
-
-**Private Composer Repositories**
-
-Refer to the [PHP7 Template Documentation](https://github.com/openfaas/templates/tree/master/template/php7) for instructions on how to use [Composers]((https://getcomposer.org/doc/)) `COMPOSER_AUTH` environment variable to configure access to dependencies in private repositories.
-
-### 9.1 PHP Extensions
-
-The PHP7 template is based upon the [Docker Library PHP image](https://hub.docker.com/_/php/) and provides the `php-extension.sh` script which exposes the ability to customise extensions installed in a function image.
-
-Refer to the [PHP7 Template Documentation](https://github.com/openfaas/templates/tree/master/template/php7) for instructions on customising installed extensions.
+> It is easy to make your own templates so if you need to use this platform please convert one of the "regular" templates for your platform.