RubyGems - station - Versions diffs - 0.0.100 → 0.0.105 - Mend

station 0.0.100 → 0.0.105

Files changed (56) hide show

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1198672d56a3ace978b43f205938e988880d40a0afa59b8d1dfad8848a483a01
-  data.tar.gz: e0ab45a38265a2bb41e44155cfcbf65523c2855bd83fcc1cd9a94b20ca50a2b3
+  metadata.gz: b4fd15fb4b49ae5927ee3c05eaac4f993aaceea3a1e25911c35abfb58a9d3b8f
+  data.tar.gz: d4c17df34ca852b9f4d2ce1d52ed160d6346cfa9d2b6aa2a57bf4b88aa5d316c
 SHA512:
-  metadata.gz: 5675f2e4ced7defa9f14af7e9ecd4f88ab7304755ee58ac28f38e9bb070a733ad290a4d921bb29e9d677ff0f9c73d65c71348f346ba77b5810a1739049286ef6
-  data.tar.gz: 7129c6147f9d6b8ab673457a7b525b6dcf620917109c61771e3ba7f9b9cadb797cb9e248bd6c27c8d7f5a047f8d68981cbb2f5da4e1b526090c7921816e02b45
+  metadata.gz: da7884bf6d7319136b26059eaf5571b6be58f770031887dbe5d01bcc4e495cb3fcccf3375ebcc4f72cb2e739bcf0d81c089cd63a47dfa2f4a6e2e74e01c636de
+  data.tar.gz: af98f932f59ac0a04dee5b7774c4feca5436bf5eda8f00c67daa99ff3fd3258a492e73625f128c17f5bdc38ffa8f04b447bf3c31f01d5f91d826839d38c55672

data/bin/nexmo-developer CHANGED

@@ -44,50 +44,7 @@ end.parse!
 $LOAD_PATH.unshift(File.expand_path('../lib/nexmo_developer', __dir__))
 APP_PATH = File.expand_path('../lib/nexmo_developer/config/application', __dir__)
-require 'rails/all'
-require 'activeadmin'
-require 'bootsnap'
-require 'bugsnag'
-require 'devise'
-require 'geocoder'
-require 'gravatar_image_tag'
-require 'greenhouse_io'
-require 'recaptcha'
-require 'split/dashboard'
-require 'listen'
-require 'inherited_resources'
-require 'msgpack'
-require 'pg'
-require 'coffee-rails'
-require 'octokit'
-require 'webpacker'
-require 'clipboard/rails'
-require 'gmaps4rails'
-require 'nexmo_markdown_renderer'
-require 'truncato'
-require 'puma'
-require 'barnes'
-require 'woothee'
-require 'algoliasearch'
-require 'rest-client'
-require 'chartkick'
-require 'groupdate'
-require 'terminal-table'
-require 'lograge'
-require 'jbuilder'
-require 'nokogiri'
-require 'colorize'
-require 'neatjson'
-require 'slack-notifier'
-require 'autoprefixer-rails'
-require 'titleize'
-require 'countries'
-require 'country_select'
-require 'smartling'
-require 'newrelic_rpm'
-require 'redis'
-require 'rake'
+require_relative '../lib/nexmo_developer/nexmo_developer'
 require 'config/application'
 require 'rails/command'

data/docs/How-To-Use.md CHANGED

@@ -49,7 +49,7 @@ The files required are:
 * `business_info.yml`: Specific business/organizational information for the platform. This includes the platform name, the path to the header and footer logos, and more.
 * `top_navigation.yml`: The links for the top navigation bar of the platform.
 * `meta_info.yml`: Information used to generate the links in the platform's `<head>` tags, such as search engine optimization details.
-* `products.yml`: A list of each product or item covered in the platform's content. The icon, documentation path and color schema for each product is also specified here.
+* `products.yml`: A list of each product or item covered in the platform's content. The icon, documentation path, color schema and automated translation frequency for each product is also specified here.
 In addition to the above configuration files, Station also expects the following files to be created and placed inside the `/public/meta` path. These files are meta icons also used in the generation of the `<head>` content:

data/lib/nexmo_developer/.rspec CHANGED

@@ -1,3 +1,2 @@
 --color
 --require spec_helper
---tag ~ndp

data/lib/nexmo_developer/Gemfile CHANGED

@@ -13,7 +13,7 @@ gem 'webpacker'
 # Use postgresql as the database for Active Record
 gem 'pg', '~> 1.2'
 # Use Puma as the app server
-gem 'puma', '~> 5.0'
+gem 'puma', '~> 5.1'
 # Use SCSS for stylesheets
 gem 'sassc-rails', '~> 2.1'
 # Use Uglifier as compressor for JavaScript assets
@@ -74,7 +74,7 @@ gem 'icalendar', require: false
 gem 'neatjson'
 # Faker, a port of Data::Faker from Perl, is used to easily generate fake data: names, addresses, phone numbers, etc.
-gem 'faker', '2.14.0', require: false
+gem 'faker', '2.15.1', require: false
 # factory_girl_rails provides integration between factory_girl and rails 3 or newer (currently just automatic factory definition loading)
 gem 'factory_bot_rails', '6.1.0', require: false
@@ -110,8 +110,8 @@ gem 'bootsnap', require: false
 gem 'diffy', require: false
 # Automatic Ruby code style checking tool. Aims to enforce the community-driven Ruby Style Guide.
-gem 'rubocop', '~> 1.3.1', require: false
-gem 'rubocop-rails', '~> 2.8', require: false
+gem 'rubocop', '~> 1.5.2', require: false
+gem 'rubocop-rails', '~> 2.9', require: false
 # Volta needs a CSS autoprefixer
 gem 'autoprefixer-rails'
@@ -131,7 +131,7 @@ gem 'country_select', '~> 4.0'
 gem 'nexmo-oas-renderer', '~> 2.4.1', require: false
-gem 'nexmo_markdown_renderer', '~> 0.5'
+gem 'nexmo_markdown_renderer', '~> 0.7.2'
 gem 'smartling'

data/lib/nexmo_developer/Gemfile.lock CHANGED

@@ -93,7 +93,7 @@ GEM
       activesupport (>= 3.0.0, < 6.1)
       ruby2_keywords (>= 0.0.2, < 1.0)
     ast (2.4.1)
-    autoprefixer-rails (10.0.2.0)
+    autoprefixer-rails (10.0.3.0)
       execjs
     awesome_print (1.8.0)
     banzai (0.1.3)
@@ -114,7 +114,7 @@ GEM
       concurrent-ruby (~> 1.0)
     builder (3.2.4)
     byebug (11.1.3)
-    capybara (3.33.0)
+    capybara (3.34.0)
       addressable
       mini_mime (>= 0.1.3)
       nokogiri (~> 1.8)
@@ -171,7 +171,7 @@ GEM
     factory_bot_rails (6.1.0)
       factory_bot (~> 6.1.0)
       railties (>= 5.0.0)
-    faker (2.14.0)
+    faker (2.15.1)
       i18n (>= 1.6, < 2)
     faraday (1.1.0)
       multipart-post (>= 1.2, < 3)
@@ -258,7 +258,7 @@ GEM
       activerecord
       kaminari-core (= 1.2.1)
     kaminari-core (1.2.1)
-    listen (3.3.1)
+    listen (3.3.3)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     lograge (0.11.2)
@@ -266,7 +266,7 @@ GEM
       activesupport (>= 4)
       railties (>= 4)
       request_store (~> 1.0)
-    loofah (2.7.0)
+    loofah (2.8.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
     lumberjack (1.2.8)
@@ -308,7 +308,7 @@ GEM
       sass (~> 3.1)
       shotgun (~> 0.9)
       sinatra (~> 2.0)
-    nexmo_markdown_renderer (0.5.1)
+    nexmo_markdown_renderer (0.7.2)
       activemodel (~> 6.0)
       banzai (~> 0.1.2)
       i18n (~> 1.7)
@@ -340,7 +340,7 @@ GEM
       sawyer (~> 0.8.0, >= 0.5.3)
     oj (3.10.15)
     orm_adapter (0.5.0)
-    parallel (1.20.0)
+    parallel (1.20.1)
     parser (2.7.2.0)
       ast (~> 2.4.1)
     pg (1.2.3)
@@ -350,7 +350,7 @@ GEM
       coderay (~> 1.1)
       method_source (~> 1.0)
     public_suffix (4.0.6)
-    puma (5.0.4)
+    puma (5.1.0)
       nio4r (~> 2.0)
     rack (2.2.3)
     rack-protection (2.1.0)
@@ -437,21 +437,21 @@ GEM
     rspec-snapshot (0.1.2)
       rspec (> 3.0.0)
     rspec-support (3.10.0)
-    rubocop (1.3.1)
+    rubocop (1.5.2)
       parallel (~> 1.10)
       parser (>= 2.7.1.5)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8)
+      regexp_parser (>= 1.8, < 3.0)
       rexml
-      rubocop-ast (>= 1.1.1)
+      rubocop-ast (>= 1.2.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 2.0)
-    rubocop-ast (1.1.1)
+    rubocop-ast (1.3.0)
       parser (>= 2.7.1.5)
-    rubocop-rails (2.8.1)
+    rubocop-rails (2.9.0)
       activesupport (>= 4.2.0)
       rack (>= 1.1)
-      rubocop (>= 0.87.0)
+      rubocop (>= 0.90.0, < 2.0)
     ruby-progressbar (1.10.1)
     ruby2_keywords (0.0.2)
     sass (3.7.4)
@@ -475,10 +475,12 @@ GEM
     shotgun (0.9.2)
       rack (>= 1.0)
     simple-random (1.0.3)
-    simplecov (0.19.1)
+    simplecov (0.20.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
     simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.2)
     sinatra (2.1.0)
       mustermann (~> 1.0)
       rack (~> 2.2)
@@ -544,7 +546,7 @@ GEM
     woothee (1.11.1)
     xpath (3.2.0)
       nokogiri (~> 1.8)
-    zeitwerk (2.4.1)
+    zeitwerk (2.4.2)
 PLATFORMS
   ruby
@@ -573,7 +575,7 @@ DEPENDENCIES
   diffy
   dotenv-rails
   factory_bot_rails (= 6.1.0)
-  faker (= 2.14.0)
+  faker (= 2.15.1)
   ffi (>= 1.9.24)
   geocoder
   gmaps4rails
@@ -590,12 +592,12 @@ DEPENDENCIES
   neatjson
   newrelic_rpm
   nexmo-oas-renderer (~> 2.4.1)
-  nexmo_markdown_renderer (~> 0.5)
+  nexmo_markdown_renderer (~> 0.7.2)
   nokogiri (~> 1.10.9)
   octokit
   pg (~> 1.2)
   pry
-  puma (~> 5.0)
+  puma (~> 5.1)
   rack (>= 2.0.6)
   rails (~> 6.0.3)
   rawler!
@@ -605,8 +607,8 @@ DEPENDENCIES
   rspec-collection_matchers
   rspec-rails (~> 4.0)
   rspec-snapshot (~> 0.1.2)
-  rubocop (~> 1.3.1)
-  rubocop-rails (~> 2.8)
+  rubocop (~> 1.5.2)
+  rubocop-rails (~> 2.9)
   ruby-progressbar
   sassc-rails (~> 2.1)
   simplecov

data/lib/nexmo_developer/app/presenters/sidenav_item.rb CHANGED

@@ -38,8 +38,8 @@ class SidenavItem
   def css_classes
     classes = ['Nxd-sidenav-badge Vlt-badge Vlt-badge--margin-left Vlt-badge--small']
-    classes << 'Vlt-bg-green-lighter Vlt-green' if label.casecmp('beta').zero?
-    classes << 'Vlt-bg-blue-lighter Vlt-blue' if label.casecmp('dev preview').zero?
+    classes << 'Vlt-badge--transparent Vlt-badge--green' if label.casecmp('beta').zero?
+    classes << 'Vlt-badge--transparent Vlt-badge--blue' if label.casecmp('dev preview').zero?
     classes.join(' ')
   end

data/lib/nexmo_developer/app/presenters/tutorial_list_item.rb CHANGED

@@ -62,11 +62,11 @@ class TutorialListItem
   end
   def product_url
-    "/#{I18n.locale}/#{products.join('')}/tutorials"
+    "/#{I18n.locale}/#{products.join}/tutorials"
   end
   def url
-    external_link || "/#{I18n.locale}/#{products.join('')}/tutorials/#{filename}/#{first_step}"
+    external_link || "/#{I18n.locale}/#{products.join}/tutorials/#{filename}/#{first_step}"
   end
   def available_languages
@@ -74,7 +74,7 @@ class TutorialListItem
       OpenStruct.new(
         language: language,
         label: Nexmo::Markdown::CodeLanguage.find(language).label,
-        url: external_link || "/#{products.join('')}/tutorials/#{filename}/#{first_step}/#{language}"
+        url: external_link || "/#{products.join}/tutorials/#{filename}/#{first_step}/#{language}"
       )
     end
   end

data/lib/nexmo_developer/app/services/translator/file_translator.rb CHANGED

@@ -1,5 +1,7 @@
 module Translator
   class FileTranslator
+    include Utils
     attr_reader :doc_path
     def initialize(doc_path)
@@ -12,41 +14,45 @@ module Translator
           Translator::TranslationRequest.new(
             locale: locale_with_region(locale),
             frequency: frequency,
-            file_uri: doc_path
+            file_uri: uri,
+            file_path: full_path
           )
         end
       end
     end
+    def uri
+      @uri ||= file_uri(doc_path)
+    end
     def frontmatter
       @frontmatter ||= YAML.safe_load(File.read(full_path))
     end
     def full_path
-      @full_path ||= "#{Rails.configuration.docs_base_path}/_documentation/en/#{doc_path}"
+      @full_path ||= "#{Rails.configuration.docs_base_path}/#{doc_path}"
     end
     def frequency
       @frequency ||= frontmatter['translation_frequency'] || product_translation_frequency
     end
-    def locale_with_region(locale)
-      case locale.to_s
-      when 'ja', 'ja-JP'
-        'ja-JP'
-      when 'cn', 'zh-CN'
-        'zh-CN'
-      else
-        locale.to_s
+    def product_from_path
+      @product_from_path ||= begin
+        Pathname.new(
+          doc_path.gsub(%r{(_documentation|_tutorials|_use_cases)/#{I18n.default_locale}/}, '')
+        ).dirname.to_s
       end
     end
     def product
       @product ||= begin
         products = YAML.safe_load(File.open("#{Rails.configuration.docs_base_path}/config/products.yml"))
-        product = products['products'].detect { |p| doc_path.starts_with? p['path'] }
+        product = products['products'].detect do |p|
+          product_from_path.starts_with?(p['path']) || frontmatter['products']&.include?(p['path'])
+        end
-        raise ArgumentError, 'Unable to match document with products list in config/products.yml' unless product
+        raise ArgumentError, "Unable to match document with products list in config/products.yml for #{full_path}" unless product
         product
       end

data/lib/nexmo_developer/app/services/translator/smartling/api/upload_file.rb CHANGED

@@ -53,8 +53,10 @@ module Translator
         def file
           @file ||= begin
             file = Tempfile.new
-            file.write Nexmo::Markdown::Pipelines::Smartling::Preprocessor.new.call(
-              File.read("#{Rails.configuration.docs_base_path}/_documentation/#{I18n.default_locale}/#{@translation_request.file_uri}")
+            file.write(
+              Nexmo::Markdown::Pipelines::Smartling::Preprocessor.new.call(
+                File.read(@translation_request.file_path)
+              )
             )
             file.rewind
             file.close

data/lib/nexmo_developer/app/services/translator/translation_request.rb CHANGED

@@ -1,11 +1,12 @@
 module Translator
   class TranslationRequest
-    attr_reader :locale, :frequency, :file_uri
+    attr_reader :locale, :frequency, :file_uri, :file_path
-    def initialize(locale:, frequency:, file_uri:)
+    def initialize(locale:, frequency:, file_uri:, file_path:)
       @locale    = locale
       @frequency = frequency
       @file_uri  = file_uri
+      @file_path = file_path
     end
   end
 end

data/lib/nexmo_developer/app/services/translator/utils.rb CHANGED

@@ -11,12 +11,33 @@ module Translator
       end
     end
+    def locale_with_region(locale)
+      case locale.to_s
+      when 'ja', 'ja-JP'
+        'ja-JP'
+      when 'cn', 'zh-CN'
+        'zh-CN'
+      else
+        locale.to_s
+      end
+    end
     def storage_folder(filename, locale)
       if filename.starts_with? '_documentation'
         dir_path = Pathname.new(file_uri(filename)).dirname.to_s
         "#{Rails.configuration.docs_base_path}/_documentation/#{locale}/#{dir_path}"
+      elsif filename.starts_with? '_use_cases'
+        "#{Rails.configuration.docs_base_path}/_use_cases/#{locale}"
       elsif filename.starts_with? 'config/locales'
         Pathname.new(file_uri(filename)).dirname.to_s
+      elsif filename.starts_with? 'config/tutorials'
+        pathname = Pathname.new(filename.gsub("config/tutorials/#{I18n.default_locale}/", ''))
+        dir_path = pathname.dirname.to_s == '.' ? '' : "/#{pathname.dirname}"
+        "#{Rails.configuration.docs_base_path}/config/tutorials/#{locale}#{dir_path}"
+      elsif filename.starts_with? '_tutorials'
+        pathname = Pathname.new(filename.gsub("_tutorials/#{I18n.default_locale}/", ''))
+        dir_path = pathname.dirname.to_s == '.' ? '' : "/#{pathname.dirname}"
+        "#{Rails.configuration.docs_base_path}/_tutorials/#{locale}#{dir_path}"
       else
         dir_path = Pathname.new(file_uri(filename)).dirname.to_s
         "#{Rails.configuration.docs_base_path}/_documentation/#{locale}/#{dir_path}"
@@ -36,7 +57,13 @@ module Translator
     end
     def file_uri(filename)
-      filename.gsub(%r{_documentation/[a-z]{2}/}, '')
+      if filename.starts_with? '_documentation'
+        filename.gsub(%r{_documentation/[a-z]{2}/}, '')
+      else
+        filename.gsub(%r{(_use_cases|_tutorials|config/tutorials)/#{I18n.default_locale}/(.*)}) do |_|
+          "#{$1}/#{$2}"
+        end
+      end
     end
   end
 end

data/lib/nexmo_developer/app/views/contribute/guides/markdown-guide.md CHANGED

@@ -28,19 +28,19 @@ navigation_weight: 3
 The purpose of the metadata is to provide useful information in the following areas:
-* Algolia search results (that is when you search in NDP)
-* Google (and other external search engine) search results
-* Information for the navbar (also sometimes called the table of contents or TOC)
+-   Algolia search results (that is when you search in NDP)
+-   Google (and other external search engine) search results
+-   Information for the navbar (also sometimes called the table of contents or TOC)
 The meta data items that can be used are described in the following table:
-Metadata | HTML generated | Description
-----|----|----
-`title` | N/A | This is the title for the topic that will be displayed in the navbar. This main be different to that display at the top of the topic. It is displayed in the Algolia search results when you search NDP.
-`description` | N/A | This is the short description for the topic. It is displayed in the Algolia search results when you search NDP. It should indicate the nature of the content of the topic.
-`meta_title` | `<head><title>The title</title>...</head>` | Used for SEO in external search engine results. This should be more descriptive than the `title` to provide additional context in the absence of the navbar. [Further reading](https://moz.com/learn/seo/title-tag).
-`meta_description` | `<head><meta name="description" content="The description">...</head>` | Used in external search engine results. Provides SEO. Should be no more than 160 characters. [Further reading](https://moz.com/learn/seo/meta-description).
-`navigation_weight` | N/A | A hint to position the topic in the navbar where a particular position is preferred. The lower the number used the higher in the navbar the item will appear. Overrides information defined in `config/navigation.yml`. In most cases you only need to add a `navigation_weight` item if your topic is not automatically displayed in your preferred position in the navbar.
+| Metadata            | HTML generated                                                        | Description                                                                                                                                                                                                                                                                                                                                                                  |
+| ------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `title`             | N/A                                                                   | This is the title for the topic that will be displayed in the navbar. This main be different to that display at the top of the topic. It is displayed in the Algolia search results when you search NDP.                                                                                                                                                                     |
+| `description`       | N/A                                                                   | This is the short description for the topic. It is displayed in the Algolia search results when you search NDP. It should indicate the nature of the content of the topic.                                                                                                                                                                                                   |
+| `meta_title`        | `<head><title>The title</title>...</head>`                            | Used for SEO in external search engine results. This should be more descriptive than the `title` to provide additional context in the absence of the navbar. [Further reading](https://moz.com/learn/seo/title-tag).                                                                                                                                                         |
+| `meta_description`  | `<head><meta name="description" content="The description">...</head>` | Used in external search engine results. Provides SEO. Should be no more than 160 characters. [Further reading](https://moz.com/learn/seo/meta-description).                                                                                                                                                                                                                  |
+| `navigation_weight` | N/A                                                                   | A hint to position the topic in the navbar where a particular position is preferred. The lower the number used the higher in the navbar the item will appear. Overrides information defined in `config/navigation.yml`. In most cases you only need to add a `navigation_weight` item if your topic is not automatically displayed in your preferred position in the navbar. |
 ### Example
@@ -62,15 +62,15 @@ When using `title` bear in mind that while something like "Overview" may be fine
 Ideally task (step) or other active topics should include a gerund. For example:
-* Installing the Vonage Command Line Interface (CLI)
+-   Installing the Vonage Command Line Interface (CLI)
 Topics providing reference information would have a noun-based title, for example:
-* The Conversation object
+-   The Conversation object
 To provide greater context in external search results a corresponding `meta_title` might contain much more specific information, for example:
-* The Vonage Conversation API Conversation object
+-   The Vonage Conversation API Conversation object
 ### Writing an effective `description`
@@ -89,7 +89,9 @@ This appears in external search engine results. While navbar titles such as "Ove
 **Headings**
 # I am a H1
 ## I am a H2
 ### I am a H3
 > Custom extension: Headings have their own slugified ID's for deep linking. For example the `h1` has an ID of `i-am-a-h1`
@@ -100,7 +102,7 @@ Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia od
 **Inline styles**
-Text can be **bold**, *italic* or ***bold and italic***. You could use ~~strikethrough~~ but please don't.
+Text can be **bold**, _italic_ or **_bold and italic_**. You could use ~~strikethrough~~ but please don't.
 You can define inline `code block` with backticks.
@@ -152,13 +154,13 @@ Find out ^[more](Tooltips are useful for when you have more information to conve
 >
 > Indentations are 4 spaces.
-* Alpha
-* Bravo
-    * Charlie
-    * Delta
-        * Echo
-    * Foxtrot
-* Golf
+-   Alpha
+-   Bravo
+    -   Charlie
+    -   Delta
+        -   Echo
+    -   Foxtrot
+-   Golf
 **Ordered Lists**
@@ -171,7 +173,7 @@ Find out ^[more](Tooltips are useful for when you have more information to conve
     1. Three
     2. Four
         1. Five
-    1. Six
+    3. Six
 3. Seven
 ## Code
@@ -184,11 +186,11 @@ See our detailed [code examples guide](/contribute/guides/code-examples) for adv
 >
 > You'll have to view the `markdown-guide.md` source to see how since showing you the syntax would result in it being processed.
-Key | Description
--- | --
-`TO_NUMBER` | The number you are sending the SMS to
-`API_KEY` | You can find this in your [account overview](https://dashboard.nexmo.com/account-overview)
-`API_SECRET` | You can find this in your [account overview](https://dashboard.nexmo.com/account-overview)
+| Key          | Description                                                                                |
+| ------------ | ------------------------------------------------------------------------------------------ |
+| `TO_NUMBER`  | The number you are sending the SMS to                                                      |
+| `API_KEY`    | You can find this in your [account overview](https://dashboard.nexmo.com/account-overview) |
+| `API_SECRET` | You can find this in your [account overview](https://dashboard.nexmo.com/account-overview) |
 ## Tabbed Content (custom plugin)
@@ -229,10 +231,10 @@ Note that `tabbed` is set to `true` for tabbed folder content.
 Example files can be found in the folder `_documentation/en/client-sdk/setup/add-sdk-to-your-app`:
-* `.config.yml`
-* `android.md`
-* `ios.md`
-* `javascript.md`
+-   `.config.yml`
+-   `android.md`
+-   `ios.md`
+-   `javascript.md`
 The rendered output can be found [here](/client-sdk/setup/add-sdk-to-your-app/javascript).
@@ -288,21 +290,21 @@ Andrew->>China: I am good thanks!
 Inline [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag) support, using both primary language tags and subtags, is provided using the following syntax.
-Language | Key | Text
--- | -- | --
-English | none | Hello World
-Spanish | `es` | [Hola Mundo](lang: 'es')
-French | `fr` | [Bonjour le monde](lang: 'fr')
-Brazilian Portuguese | `pt-BR` | [Olá Mundo](lang: 'pt-BR')
-Hebrew | `il` | [שלום עולם](lang: 'il')
+| Language             | Key     | Text                           |
+| -------------------- | ------- | ------------------------------ |
+| English              | none    | Hello World                    |
+| Spanish              | `es`    | [Hola Mundo](lang: "es")       |
+| French               | `fr`    | [Bonjour le monde](lang: "fr") |
+| Brazilian Portuguese | `pt-BR` | [Olá Mundo](lang: "pt-BR")     |
+| Hebrew               | `il`    | [שלום עולם](lang: "il")        |
 ## Anchors (custom plugin)
 Adding custom anchors and retaining support for old headings can be done as such:
-````
+```
 ⚓ This is the old heading
-````
+```
 This would produce the following HTML:
@@ -312,12 +314,12 @@ This would produce the following HTML:
 If you are adding support for a changed header this would normally go above the old heading as such:
-````
+```
 ⚓ Send with Short Message Service
 ⚓ Send with SMS
 # Sending an SMS
-````
+```
 ### Example
@@ -365,9 +367,9 @@ image: public/assets/screenshots/da5f952d465355c19eb888fa1049844b31e090c2.png
 The HTML `<audio>` element can be utilised in Markdown with the following syntax:
-````
+```
 🔈[https://developer.nexmo.com.s3.amazonaws.com/assets/ssml/06-phonemes.mp3]
-````
+```
 This produces the following output:
@@ -377,9 +379,9 @@ This produces the following output:
 You can use syntax such as:
-````
+```
 Welcome to [~dynamic_content_example~]
-````
+```
 This will render as:
@@ -405,7 +407,7 @@ Alternatively, you can specify the concepts to list manually if you need to show
 ````
 ```concept_list
-concepts:
+concepts:
   - voice/voice-api/call-flow
   - messaging/sms/delivery-receipts
 ```
@@ -414,7 +416,27 @@ concepts:
 This produces the following output:
 ```concept_list
-concepts:
+concepts:
   - voice/voice-api/call-flow
   - messaging/sms/delivery-receipts
 ```
+## Snippet Variables (custom plugin)
+When writing a code snippet, you may need to define variables that the snippet will use and provide a description of each. The description will be shown in the selected language if a translation is available.
+The variables are defined in `config/code_snippet_variables.yml`
+````
+```snippet_variables
+- NEXMO_API_KEY
+- TO_NUMBER
+```
+````
+Produces the following output:
+```snippet_variables
+- NEXMO_API_KEY
+- TO_NUMBER
+```