lono 4.0.0 → 4.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 813d3d801fda95c8b91d3664909e105efa0233aa589324dd8480ff70d8364e83
-  data.tar.gz: 47425854afafa70350676c4e2a8af6b409c10f272d0547e679d45bec168ed0e5
+  metadata.gz: a05093ad7da8ea1a203d0583ccaf9823fd835bb6574943367a6faae76c1b1feb
+  data.tar.gz: d7e4484799d0024ea6d230fe1aca0da86eb2359b7e4cb5ccb0eaaad088c5c554
 SHA512:
-  metadata.gz: c8c3bcc99b77b005f58d93d6893e44e74badf2bb86dc44dda78d0d364f003c4473a847ad7875ccbd9fac77177e884214dfdd0c546e80b0d5e9013a4652bacf2a
-  data.tar.gz: '049cebb1112d4ddacbe892965b615fffd93b0fc96ced048aae471d4798d42852f544f3a2ba51989ea711a88661cb3ccb76104afac4c5e204cf21efe52f7736b4'
+  metadata.gz: 660d43b879898e550cf3ed5039220e00c5c9af11189e03d1dd8284c93223dd888b2127a0548abbecf81b22a0479fe3bcc8461f9dc0dd82488df6558e1fd5364f
+  data.tar.gz: ba6a544e8fe3d24b1528df365c63a8e0e2c4fc55aa6d5729e1ad7e0cc4bc55a27aee465c7c6f42abcc470399f830268a6455c9cd77607ddbf002befe190cd91a

data/.circleci/bin/commit_docs.sh

@@ -0,0 +1,26 @@
+#!/bin/bash -eux
+
+# Even though specs also generate docs, lets run again to ensure clean slate
+rake docs
+
+out=$(git status docs)
+if [[ "$out" = *"nothing to commit"* ]]; then
+  exit
+fi
+
+COMMIT_MESSAGE="docs updated by circleci"
+
+# If the last commit already updated the docs, then exit.
+# Preventable measure to avoid infinite loop.
+if git log -1 --pretty=oneline | grep "$COMMIT_MESSAGE" ; then
+  exit
+fi
+
+# If reach here, we have some changes on docs that we should commit.
+# Even though s
+git add docs
+git commit -m "$COMMIT_MESSAGE"
+
+# https://makandracards.com/makandra/12107-git-show-current-branch-name-only
+current_branch=$(git rev-parse --abbrev-ref HEAD)
+git push origin "$current_branch"

data/.circleci/config.yml

@@ -42,6 +42,13 @@ jobs:
             - ./vendor/bundle
           key: v1-dependencies-{{ checksum "Gemfile" }}
 
+      # specs need git configured ad commit_docs.sh required it also
+      - run:
+          name: configure git
+          command: |
+            git config --global user.email "tongueroo@gmail.com"
+            git config --global user.name "Tung Nguyen"
+
       # run tests!
       - run:
           name: run tests
@@ -49,6 +56,14 @@ jobs:
             mkdir /tmp/test-results
             bundle exec rspec
 
+      # The specs will generate reference docs.
+      # Commit it again so that the reference docs are published to GitHub pages.
+      - run:
+          name: commit cli reference docs
+          command: |
+            chmod a+x -R .circleci/bin
+            .circleci/bin/commit_docs.sh
+
       # collect reports
       - store_test_results:
           path: /tmp/test-results

data/CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 This project *tries* to adhere to [Semantic Versioning](http://semver.org/), even before v1.0.
 
+## [4.0.1]
+- add http://lono.cloud/reference/
+- improve cli docs
+
 ## [4.0.0]
 - lono upgrade4 command
 - simplified lono project structure

data/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="http://lono.cloud/img/logos/lono-logo.png" style="max-width: 300px" />
+  <img src="http://lono.cloud/img/logos/lono-logo-small.png" />
 </div>
 
 # Lono
@@ -15,7 +15,7 @@
 [3]: https://codeclimate.com/repos/51d7f1407e00a4042c010ab4/badges/5273fe6cdb5a13e58554/gpa.png
 [4]: https://codeclimate.com/repos/51d7f1407e00a4042c010ab4/feed
 
-Lono is a tool to help you manage your CloudFormation templates. Lono handles the entire CloudFormation lifecyle. It helps you craft the templates and then provisions of the infrastructure.
+Lono is a tool to help you manage your CloudFormation templates. Lono handles the entire CloudFormation lifecyle. It helps you craft the templates and then provision the infrastructure.
 
 * Lono generates CloudFormation templates based on ERB ruby templates in `yaml` format.
 * Lono takes simple env-like files and generates the CloudFormation parameter files.

data/Rakefile

@@ -4,3 +4,9 @@ require "rspec/core/rake_task"
 task :default => :spec
 
 RSpec::Core::RakeTask.new
+
+require_relative "lib/lono"
+desc "Generates cli reference docs as markdown"
+task :docs do
+  Lono::Markdown::Creator.create_all(Lono::CLI)
+end

data/lib/lono/cfn/diff.rb

@@ -38,7 +38,7 @@ class Lono::Cfn::Diff < Lono::Cfn::Base
   end
 
   def diff_viewer
-    return ENV['LONO_CFN_DIFF'] if ENV['LONO_CFN_DIFF']
+    return ENV['LONO_DIFF'] if ENV['LONO_DIFF']
     system("type colordiff > /dev/null") ? "colordiff" : "diff"
   end
 

data/lib/lono/cfn.rb

@@ -14,7 +14,6 @@ class Lono::Cfn < Lono::Command
 
   class_option :verbose, type: :boolean
   class_option :noop, type: :boolean
-  class_option :region, desc: "AWS region"
 
   # common to create and update
   class_option :template, desc: "override convention and specify the template file to use"
@@ -24,14 +23,14 @@ class Lono::Cfn < Lono::Command
   class_option :iam, type: :boolean, desc: "Shortcut for common IAM capabilities: CAPABILITY_IAM, CAPABILITY_NAMED_IAM"
   class_option :rollback, type: :boolean, desc: "rollback", default: true
 
-  desc "create STACK", "create a CloudFormation stack"
+  desc "create STACK", "Create a CloudFormation stack using the generated template."
   option :randomize_stack_name, type: :boolean, desc: "tack on random string at the end of the stack name", default: nil
   long_desc Lono::Help.text("cfn/create")
   def create(name)
     Create.new(name, options).run
   end
 
-  desc "update STACK", "update a CloudFormation stack"
+  desc "update STACK", "Update a CloudFormation stack using the generated template."
   long_desc Lono::Help.text("cfn/update")
   option :change_set, type: :boolean, default: true, desc: "Uses generated change set to update the stack.  If false, will perform normal update-stack."
   option :diff, type: :boolean, default: true, desc: "Show diff of the source code template changes before continuing."
@@ -41,14 +40,14 @@ class Lono::Cfn < Lono::Command
     Update.new(name, options).run
   end
 
-  desc "delete STACK", "delete a CloudFormation stack"
+  desc "delete STACK", "Delete a CloudFormation stack."
   long_desc Lono::Help.text("cfn/delete")
   option :sure, type: :boolean, desc: "Skips are you sure prompt"
   def delete(name)
     Delete.new(name, options).run
   end
 
-  desc "preview STACK", "preview a CloudFormation stack update"
+  desc "preview STACK", "Preview a CloudFormation stack update.  This is similar to terraform's plan or puppet's dry-run mode."
   long_desc Lono::Help.text("cfn/preview")
   option :keep, type: :boolean, desc: "keep the changeset instead of deleting it afterwards"
   option :diff, type: :boolean, default: true, desc: "Show diff of the source code template changes also."
@@ -57,13 +56,13 @@ class Lono::Cfn < Lono::Command
     Preview.new(name, options).run
   end
 
-  desc "diff STACK", "diff of newly generated template vs existing template in AWS"
+  desc "diff STACK", "Diff newly generated template vs existing template."
   long_desc Lono::Help.text("cfn/diff")
   def diff(name)
     Diff.new(name, options).run
   end
 
-  desc "download STACK", "download CloudFormation template from existing stack"
+  desc "download STACK", "Download CloudFormation template from existing stack."
   long_desc Lono::Help.text("cfn/download")
   option :name, desc: "Name you want to save the template as. Default: existing stack name."
   def download(stack_name)

data/lib/lono/cli.rb

@@ -7,7 +7,7 @@ module Lono
     end
     register(New, "new", "new NAME", "generates new CLI project")
 
-    desc "import SOURCE", "Imports raw CloudFormation template and lono-fies it"
+    desc "import SOURCE", "Imports CloudFormation template and lono-fies it."
     long_desc Help.text(:import)
     option :name, required: true, default: nil, desc: "final name of downloaded template without extension"
     option :summary, default: true, type: :boolean, desc: "provide template summary after import"
@@ -41,14 +41,14 @@ module Lono
     end
 
     desc "xgraph STACK", "Graphs dependencies tree of CloudFormation template resources"
-    long_desc Help.text("graph")
+    long_desc Help.text("xgraph")
     option :display, type: :string, desc: "graph or text", default: "graph"
     option :noop, type: :boolean, desc: "noop mode"
     def xgraph(name)
       Lono::Inspector::Graph.new(name, options).run
     end
 
-    desc "clean", "Clean up generated files"
+    desc "clean", "Clean up generated files in `output` folder."
     def clean
       Clean.new(options).run
     end
@@ -59,14 +59,14 @@ module Lono
       Completer.new(CLI, *params).run
     end
 
-    desc "completion_script", "generates script that can be eval to setup auto-completion", hide: true
+    desc "completion_script", "generates script that can be eval to setup auto-completion"
     long_desc Help.text("completion_script")
     def completion_script
       Completer::Script.generate
     end
 
-    desc "upgrade4", "upgrade from version 3 to 4"
-    long_desc Help.text("upgrade3")
+    desc "upgrade4", "Upgrade from version 3 to 4."
+    long_desc Help.text("upgrade4")
     def upgrade4
       Upgrade4.new(options).run
     end
@@ -76,19 +76,19 @@ module Lono
       puts VERSION
     end
 
-    desc "template SUBCOMMAND", "template subcommand tasks"
+    desc "template SUBCOMMAND", "template subcommands"
     long_desc Help.text(:template)
     subcommand "template", Template
 
-    desc "cfn SUBCOMMAND", "cfn subcommand tasks"
+    desc "cfn SUBCOMMAND", "cfn subcommands"
     long_desc Help.text(:cfn)
     subcommand "cfn", Cfn
 
-    desc "param SUBCOMMAND", "param subcommand tasks"
+    desc "param SUBCOMMAND", "param subcommands"
     long_desc Help.text(:param)
     subcommand "param", Param
 
-    desc "script SUBCOMMAND", "script subcommand tasks"
+    desc "script SUBCOMMAND", "script subcommands"
     long_desc Help.text(:script)
     subcommand "script", Script
   end

data/lib/lono/command.rb

@@ -42,6 +42,20 @@ module Lono
 
         super
       end
+
+      # Override command_help to include the description at the top of the
+      # long_description.
+      def command_help(shell, command_name)
+        meth = normalize_command_name(command_name)
+        command = all_commands[meth]
+        long_desc = if command.long_description
+            "#{command.description}\n\n#{command.long_description}"
+          else
+            command.description
+          end
+        command.long_description = long_desc
+        super
+      end
     end
   end
 end

data/lib/lono/help/cfn/create.md

@@ -1,22 +1,21 @@
-Examples:
+## Examples
 
-Provided that you are in a lono project and have a `my-stack` lono template definition.  To create a stack you can simply run:
+Provided that you are in a lono project and have a `my-stack` lono template definition.  To create a stack you can run:
 
   lono cfn create my-stack
 
-The above command will generate and use the template in output/my-stack.json and parameters in params/my-stack.txt.  The template by convention defaults to the name of the stack.  In turn, the params by convention defaults to the name of the template.
+The above command will generate and use the template in `output/templates/my-stack.json` and parameters in `output/params/my-stack.txt`.  By [convention]({% link _docs/conventions.md %}), the template defaults to the name of the stack.  In turn, the params defaults to the name of the template.
 
 Here are examples of overriding the template and params name conventions.
 
   lono cfn create my-stack --template different1
 
-The template used is output/different1.json and the parameters used is output/params/prod/different1.json.
+The template used is `output/templates/different1.json` and the parameters used is `output/params/different1.json`.
 
   lono cfn create my-stack --params different2
 
-The template used is output/my-stack.json and the parameters used is output/params/prod/different2.json.
+The template used is `output/templates/my-stack.json` and the parameters used is `output/params/different2.json`.
 
   lono cfn create my-stack --template different3 --params different4
 
-The template used is output/different3.json and the parameters used is output/params/prod/different4.json.
-
+The template used is `output/templates/different3.json` and the parameters used is `output/params/different4.json`.

data/lib/lono/help/cfn/delete.md

@@ -1,5 +1,13 @@
-Examples:
+## Examples
 
-  lono cfn delete my-stack
+    $ lono cfn delete ec2
+    Are you sure you want to want to delete the stack? (y/N)
+    y
+    Deleted example stack.
+    $
 
-The above command will delete my-stack.
+Lono prompts you with an "Are you sure?" message before the stack gets deleted.  If you would like to bypass the prompt, you can use the `--sure` flag.
+
+    $ lono cfn delete example --sure
+    Deleted example stack.
+    $

data/lib/lono/help/cfn/diff.md

@@ -1,5 +1,14 @@
-Displays code diff of the generated CloudFormation template locally vs the existing template on AWS. You can set a desired diff viewer by setting the LONO_CFN_DIFF environment variable.
+Displays code diff of the generated CloudFormation template locally vs the existing template on AWS. You can set a desired diff viewer by setting the `LONO_DIFF` environment variable.
 
-Examples:
+## Examples
 
-  lono cfn diff my-stack
+    lono cfn diff my-stack
+
+The output should look similiar to this:
+
+<img src="/img/tutorials/ec2/cfn-update-instance-type.png" alt="Stack Update" class="doc-photo">
+
+Notice that before the update gets performed lono provides a preview of the changes that are about to take place. There are two types of "diffs" in the preview.
+
+1. Source code diff of the templates. This is generated by downloading the current CloudFormation template and comparing it with the locally generated one using `colordiff`.
+2. CloudFormation Change Set list of changes. This is generated using [AWS CloudFormation Change Set](https://medium.com/boltops/a-simple-introduction-to-cloudformation-part-4-change-sets-dry-run-mode-c14e41dfeab7) feature.

data/lib/lono/help/cfn/download.md

@@ -1,5 +1,3 @@
-Download CloudFormation template from existing template on AWS.
-
-Examples:
+## Examples
 
   lono cfn download my-stack

data/lib/lono/help/cfn/preview.md

@@ -1,11 +1,26 @@
-Generates a CloudFormation preview.  This is similar to a `terraform plan` or puppet's dry-run mode.
+## Examples
 
-Example output:
+We'll make a change to the default InstanceType of a CloudFromation stack.
 
-CloudFormation preview for 'example' stack update. Changes:
+    lono cfn preview my-stack
 
-Remove AWS::Route53::RecordSet: DnsRecord testsubdomain.sub.tongueroo.com
+The output should look similiar to this:
 
-Examples:
+    Generating CloudFormation source code diff...
+    Running: colordiff /tmp/existing_cfn_template.yml output/templates/ec2.yml
+    14c14
+    <     Default: t2.small
+    ---
+    >     Default: t2.micro
+    Generating CloudFormation Change Set for preview.....
+    CloudFormation preview for 'ec2' stack update. Changes:
+    Modify AWS::EC2::Instance: EC2Instance i-07e939db65120fb75
 
-  lono cfn preview my-stack
+The preview includes colors:
+
+<img src="/img/reference/lono-cfn-preview.png" alt="Stack Update" class="doc-photo">
+
+Notice that before the update gets performed lono provides a preview of the changes that are about to take place. There are two types of "diffs" in the preview.
+
+1. Source code diff of the templates. This is generated by downloading the current CloudFormation template and comparing it with the locally generated one using `colordiff`.
+2. CloudFormation Change Set list of changes. This is generated using [AWS CloudFormation Change Set](https://medium.com/boltops/a-simple-introduction-to-cloudformation-part-4-change-sets-dry-run-mode-c14e41dfeab7) feature.

data/lib/lono/help/cfn/update.md

@@ -1,21 +1,21 @@
-Examples:
+## Examples
 
 Provided that you are in a lono project and have a `my-stack` lono template definition.  To update a stack you can simply run:
 
   lono cfn update my-stack
 
-The above command will generate and use the template in output/my-stack.json and parameters in params/my-stack.txt.  The template by convention defaults to the name of the stack.  In turn, the params by convention defaults to the name of the template.
+The above command will generate and use the template in `output/templates/my-stack.json` and parameters in `output/params/my-stack.txt`.  The template by convention defaults to the name of the stack.  In turn, the params by convention defaults to the name of the template.
 
 Here are examples of overriding the template and params name conventions.
 
   lono cfn update my-stack --template different1
 
-The template used is output/different1.json and the parameters used is output/params/prod/different1.json.
+The template used is `output/templates/different1.json` and the parameters used is `output/params/different1.json`.
 
   lono cfn update my-stack --params different2
 
-The template used is output/my-stack.json and the parameters used is output/params/prod/different2.json.
+The template used is `output/templates/my-stack.json` and the parameters used is `output/params/different2.json`.
 
   lono cfn update my-stack --template different3 --params different4
 
-The template used is output/different3.json and the parameters used is output/params/prod/different4.json.
+The template used is `output/templates/different3.json` and the parameters used is `output/params/different4.json`.

data/lib/lono/help/cfn.md

@@ -1,4 +1,4 @@
-Examples:
+## Examples
 
   lono cfn create my-stack
   lono cfn preview my-stack

data/lib/lono/help/completion.md

@@ -1,14 +1,14 @@
-Example:
+## Example
 
   lono completion
 
 Prints words for TAB auto-completion.
 
-Examples:
+## Examples
 
   lono completion
-  lono completion hello
-  lono completion hello name
+  lono completion cfn
+  lono completion cfn create
 
 To enable, TAB auto-completion add the following to your profile:
 
@@ -17,6 +17,6 @@ To enable, TAB auto-completion add the following to your profile:
 Auto-completion example usage:
 
   lono [TAB]
-  lono hello [TAB]
-  lono hello name [TAB]
-  lono hello name --[TAB]
+  lono cfn [TAB]
+  lono cfn create [TAB]
+  lono cfn create --[TAB]

data/lib/lono/help/completion_script.md

@@ -1,3 +1,3 @@
-To use, add the following to your ~/.bashrc or ~/.profile
+To use, add the following to your `~/.bashrc` or `~/.profile`:
 
-  eval $(lono completion script)
+    eval $(lono completion script)

data/lib/lono/help/generate.md

@@ -1,7 +1,18 @@
-Examples:
+Generates CloudFormation template, parameter files, and scripts in lono project. Writes writes them to the `output` folder.
 
-  lono generate
-  lono generate --clean
-  lono g --clean # shortcut
+## Examples
 
-Builds both CloudFormation template and parameter files based on lono project and writes them to the output folder on the filesystem.
+    lono generate
+    lono generate --clean
+    lono g --clean # shortcut
+
+## Example Output
+
+    $ lono generate
+    Generating CloudFormation templates, parameters, and scripts
+    No detected app/scripts
+    Generating CloudFormation templates:
+      output/templates/ec2.yml
+    Generating parameter files:
+      output/params/ec2.json
+    $

data/lib/lono/help/import.md

@@ -1,7 +1,27 @@
-Examples:
+## Examples
 
-  lono import /path/to/file
-  lono import http://url.com/path/to/template.json
-  lono import http://url.com/path/to/template.yml
+    lono import /path/to/file
+    lono import http://url.com/path/to/template.json
+    lono import http://url.com/path/to/template.yml
 
-Imports a raw CloudFormation template and lono-fies it.
+## Example Output
+
+    $ lono import https://s3-us-west-2.amazonaws.com/cloudformation-templates-us-west-2/EC2InstanceWithSecurityGroupSample.template --name ec2
+    => Imported CloudFormation template and lono-fied it.
+    Template definition added to app/definitions/base.rb
+    Params file created to config/params/base/ec2.txt
+    Template downloaded to app/templates/ec2.yml
+    => CloudFormation Template Summary:
+    Parameters:
+    Required:
+      KeyName (AWS::EC2::KeyPair::KeyName)
+    Optional:
+      InstanceType (String) Default: t2.small
+      SSHLocation (String) Default: 0.0.0.0/0
+    Resources:
+      1 AWS::EC2::Instance
+      1 AWS::EC2::SecurityGroup
+      2 Total
+    Here are contents of the params config/params/base/ec2.txt file:
+    KeyName=
+    #InstanceType=        # optional

data/lib/lono/help/new.md

@@ -1,8 +1,54 @@
-Examples:
+## Examples
 
-  lono new infra # skeleton project with barebones structure
-  TEMPLATE=ec2 lono new infra # creates a single server
-  TEMPLATE=autoscaling lono new infra
+    lono new infra # skeleton project with barebones structure
+    TEMPLATE=ec2 lono new infra # creates a single server
+    TEMPLATE=autoscaling lono new infra
 
-For a list of the starter templates:
-https://github.com/tongueroo/lono/tree/master/lib/starter_projects
+List of the [starter templates[(https://github.com/tongueroo/lono/tree/master/lib/starter_projects).
+
+## Example Output
+
+    $ lono new ec2
+    => Creating new project called ec2.
+          create  ec2
+          create  ec2/.gitignore
+          create  ec2/Gemfile
+          create  ec2/Guardfile
+          create  ec2/README.md
+          create  ec2/app/definitions/base.rb
+          create  ec2/config/settings.yml
+          create  ec2/welcome.txt
+          create  ec2/app/helpers
+          create  ec2/app/partials
+          create  ec2/app/scripts
+          create  ec2/app/templates
+          create  ec2/app/user_data
+          create  ec2/config/params
+          create  ec2/config/variables
+          create  ec2/output
+    => Installing dependencies with: bundle install
+    => Initialize git repo
+    ================================================================
+    Congrats 🎉 You have successfully created a lono project.
+
+    Cd into your project and check things out:
+
+      cd ec2
+
+    Add and edit templates for your project.  When you are ready to launch a CloudFormation stack run:
+
+      lono cfn create STACK_NAME
+
+    You can also get started quickly by importing other CloudFormation templates into lono.  For example:
+
+      lono import https://s3-us-west-2.amazonaws.com/cloudformation-templates-us-west-2/EC2InstanceWithSecurityGroupSample.template --name ec2
+
+    To re-generate your templates without launching a stack, you can run:
+
+      lono generate
+
+    The generated CloudFormation templates are in the output/templates folder.
+    The generated stack parameters are in the output/params folder.  Here's the command with some output filtered to focus on learning.
+
+    More info: http://lono.cloud/
+    $

data/lib/lono/help/param/generate.md

@@ -1,7 +1,5 @@
-Example:
+## Example
 
-To generate a CloudFormation json parameter files in the params folder to the output/params folder.
+To generate a CloudFormation json parameter files in the params folder to the `output/params` folder.
 
-  lono-params generate
-
-If you have params/my-stack.txt. It will generate a CloudFormation json file in output/params/my-stack.json.
+    lono param generate

data/lib/lono/help/param.md

@@ -1,3 +1,3 @@
-Examples:
+## Examples
 
   lono param generate

data/lib/lono/help/script/build.md

@@ -1,5 +1,3 @@
-Builds output/scripts/scripts-md5sum.tgz from app/script folder.
-
-Examples:
+## Examples
 
   lono script build

data/lib/lono/help/script/upload.md

@@ -1,8 +1,8 @@
-Uploads output/scripts/scripts-md5sum.tgz to s3_folder configured in settings.yml.  This command must be ran after `lono script build` since it relies the artifacts of that command. Namely:
+This command must be ran after `lono script build` since it relies the artifacts of that command. Namely:
 
   * output/scripts/scripts-md5sum.tgz
   * output/data/scripts_name.txt
 
-Examples:
+## Examples
 
   lono script upload

data/lib/lono/help/summary.md

@@ -0,0 +1,19 @@
+Lono inspect is provides commands to help you quickly understand a CloudFormation template.
+
+## Examples
+
+    $ lono summary ec2
+    => CloudFormation Template Summary:
+    Parameters:
+    Required:
+      KeyName (AWS::EC2::KeyPair::KeyName)
+    Optional:
+      InstanceType (String) Default: t2.micro
+      SSHLocation (String) Default: 0.0.0.0/0
+    Resources:
+      1 AWS::EC2::Instance
+      1 AWS::EC2::SecurityGroup
+      2 Total
+    $
+
+Blog Post also covers this: [lono inspect summary Tutorial Introduction](https://blog.boltops.com/2017/09/18/lono-inspect-summary-tutorial-introduction)

data/lib/lono/help/template/bashify.md

@@ -1,4 +1,4 @@
-Examples:
+## Examples
 
   lono template bashify /path/to/cloudformation-template.json
   lono template bashify https://s3.amazonaws.com/cloudformation-templates-us-east-1/EC2WebSiteSample.template

data/lib/lono/help/template/generate.md

@@ -1,4 +1,4 @@
-Examples:
+## Examples
 
   lono template generate
   lono template generate --clean

data/lib/lono/help/template.md

@@ -1,4 +1,4 @@
-Examples:
+## Examples
 
   lono template generate --help
   lono template bashify --help