workarea 3.4.16 → 3.4.17

data/docs/Gemfile.lock

@@ -1,130 +0,0 @@
-GEM
-  remote: https://rubygems.org/
-  specs:
-    activesupport (5.0.7.2)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-    addressable (2.7.0)
-      public_suffix (>= 2.0.2, < 5.0)
-    autoprefixer-rails (9.6.1.1)
-      execjs
-    backports (3.15.0)
-    coffee-script (2.4.1)
-      coffee-script-source
-      execjs
-    coffee-script-source (1.12.2)
-    concurrent-ruby (1.1.5)
-    contracts (0.13.0)
-    dotenv (2.7.5)
-    erubis (2.7.0)
-    execjs (2.7.0)
-    fast_blank (1.0.0)
-    fastimage (2.1.7)
-    ffi (1.11.1)
-    haml (5.1.2)
-      temple (>= 0.8.0)
-      tilt
-    hamster (3.0.0)
-      concurrent-ruby (~> 1.0)
-    hashie (3.6.0)
-    i18n (0.9.5)
-      concurrent-ruby (~> 1.0)
-    kramdown (1.17.0)
-    libv8 (3.16.14.19-x86_64-linux)
-    listen (3.0.8)
-      rb-fsevent (~> 0.9, >= 0.9.4)
-      rb-inotify (~> 0.9, >= 0.9.7)
-    memoist (0.16.0)
-    middleman (4.3.5)
-      coffee-script (~> 2.2)
-      haml (>= 4.0.5)
-      kramdown (~> 1.2)
-      middleman-cli (= 4.3.5)
-      middleman-core (= 4.3.5)
-    middleman-autoprefixer (2.10.1)
-      autoprefixer-rails (~> 9.1)
-      middleman-core (>= 3.3.3)
-    middleman-cli (4.3.5)
-      thor (>= 0.17.0, < 2.0)
-    middleman-core (4.3.5)
-      activesupport (>= 4.2, < 5.1)
-      addressable (~> 2.3)
-      backports (~> 3.6)
-      bundler
-      contracts (~> 0.13.0)
-      dotenv
-      erubis
-      execjs (~> 2.0)
-      fast_blank
-      fastimage (~> 2.0)
-      hamster (~> 3.0)
-      hashie (~> 3.4)
-      i18n (~> 0.9.0)
-      listen (~> 3.0.0)
-      memoist (~> 0.14)
-      padrino-helpers (~> 0.13.0)
-      parallel
-      rack (>= 1.4.5, < 3)
-      sassc (~> 2.0)
-      servolux
-      tilt (~> 2.0.9)
-      uglifier (~> 3.0)
-    middleman-navtree (0.1.11)
-      middleman-core (>= 3.3)
-      titleize (~> 1.3)
-    middleman-search (0.10.0)
-      middleman-core (>= 3.2)
-      nokogiri (~> 1.6)
-      therubyracer (~> 0.12.2)
-    mini_portile2 (2.4.0)
-    minitest (5.11.3)
-    nio4r (2.5.1)
-    nokogiri (1.10.4)
-      mini_portile2 (~> 2.4.0)
-    padrino-helpers (0.13.3.4)
-      i18n (~> 0.6, >= 0.6.7)
-      padrino-support (= 0.13.3.4)
-      tilt (>= 1.4.1, < 3)
-    padrino-support (0.13.3.4)
-      activesupport (>= 3.1)
-    parallel (1.17.0)
-    public_suffix (4.0.1)
-    puma (4.1.1)
-      nio4r (~> 2.0)
-    rack (2.0.7)
-    rb-fsevent (0.10.3)
-    rb-inotify (0.10.0)
-      ffi (~> 1.0)
-    redcarpet (3.5.0)
-    ref (2.0.0)
-    sassc (2.2.0)
-      ffi (~> 1.9)
-    servolux (0.13.0)
-    temple (0.8.2)
-    therubyracer (0.12.3)
-      libv8 (~> 3.16.14.15)
-      ref
-    thor (0.20.3)
-    thread_safe (0.3.6)
-    tilt (2.0.9)
-    titleize (1.4.1)
-    tzinfo (1.2.5)
-      thread_safe (~> 0.1)
-    uglifier (3.2.0)
-      execjs (>= 0.3.0, < 3)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  middleman (~> 4.2)
-  middleman-autoprefixer (~> 2.9)
-  middleman-navtree (~> 0.1.10)
-  middleman-search (~> 0.10.0)
-  puma
-  redcarpet
-
-BUNDLED WITH
-   2.0.2

data/docs/bin/middleman

@@ -1,29 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-#
-# This file was generated by Bundler.
-#
-# The application 'middleman' is installed as part of a gem, and
-# this file is here to facilitate running it.
-#
-
-require "pathname"
-ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
-  Pathname.new(__FILE__).realpath)
-
-bundle_binstub = File.expand_path("../bundle", __FILE__)
-
-if File.file?(bundle_binstub)
-  if File.read(bundle_binstub, 150) =~ /This file was generated by Bundler/
-    load(bundle_binstub)
-  else
-    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
-Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
-  end
-end
-
-require "rubygems"
-require "bundler/setup"
-
-load Gem.bin_path("middleman-cli", "middleman")

data/docs/config.rb

@@ -1,87 +0,0 @@
-require_relative './workarea_renderer'
-
-# Activate and configure extensions
-# https://middlemanapp.com/advanced/configuration/#configuring-extensions
-
-set :markdown_engine, :redcarpet
-set :markdown, fenced_code_blocks: true, tables: true, no_intra_emphasis: true, renderer: WorkareaRenderer
-
-set :relative_links, true
-
-set :feedback_url, 'https://docs.google.com/forms/d/e/1FAIpQLSdwBiHq_F8TVPAcBQFGf9e--yCE6rbGvGuiAF-W2lB2zrRbtg/viewform?usp=pp_url&entry.1298659050='
-
-activate :search do |search|
-  search.resources = Dir['source/**/*.html*'].map do |path|
-    path.split('/').drop(1).join('/').gsub(/\.erb|\.md/, '')
-  end
-
-  search.fields = {
-    title: { boost: 100, store: true, required: true },
-    content: { boost: 50 },
-    excerpt: { index: false, store: true },
-    url:     { index: false, store: true }
-  }
-end
-
-activate :navtree do |options|
-  options.automatic_tree_updates = false
-end
-
-# Layouts
-# https://middlemanapp.com/basics/layouts/
-
-# Per-page layout changes
-page '/*.xml', layout: false
-page '/*.json', layout: false
-page '/*.txt', layout: false
-
-# With alternative layout
-page '/articles/*', layout: 'article'
-page '/release-notes/*', layout: 'bare'
-page '/upgrade-guides/*', layout: 'bare'
-
-# Proxy pages
-# https://middlemanapp.com/advanced/dynamic-pages/
-
-# proxy(
-#   '/this-page-has-no-template.html',
-#   '/template-file.html',
-#   locals: {
-#     which_fake_page: 'Rendering a fake page with a local variable'
-#   },
-# )
-
-# Helpers
-# Methods defined in the helpers block are available in templates
-# https://middlemanapp.com/basics/helper-methods/
-
-helpers do
-  def body_classes(classes = '')
-    ['body', current_page.data.body_class, classes].join(' ')
-  end
-
-  def recent_articles(size = 5)
-    files = Dir['source/{articles,hosting}/**/*.md']
-              .map { |p| File.new(p) }
-              .sort { |y, x| x.ctime <=> y.ctime }
-
-    files.take(size).map do |file|
-      sitemap.resources.find { |r| file.path.include?(r.path) }
-    end
-  end
-end
-
-# Build-specific configuration
-# https://middlemanapp.com/advanced/configuration/#environment-specific-settings
-
-configure :build do
-  activate :minify_css
-  activate :minify_javascript
-  activate :relative_assets
-
-  # Keep this here, as per:
-  # https://github.com/middleman/middleman-autoprefixer/issues/33
-  activate :autoprefixer do |prefix|
-    prefix.browsers = "last 2 versions"
-  end
-end

data/docs/config.ru

@@ -1,7 +0,0 @@
-require 'bundler/setup'
-Bundler.require(:default)
-
-middleman = Middleman::Application.new
-app = Middleman::Rack.new(middleman).to_app
-
-run app

data/docs/data/articles.yml

@@ -1,157 +0,0 @@
-introduction:
-  overview.html.md: /articles/overview.html.md
-  api-overview.html.md: /articles/api-overview.html.md
-  b2b-overview.html.md: /articles/b2b-overview.html.md
-developing-on-workarea:
-  quick-start:
-    create-a-new-app.html.md: /articles/create-a-new-app.html.md
-    use-an-existing-workarea-app.html.md: /articles/use-an-existing-workarea-app.html.md
-  installing.html.md: /articles/installing.html.md
-  navigating-the-code.html.md: /articles/navigating-the-code.html.md
-  seeds.html.md: /articles/seeds.html.md
-  integrating-with-other-software: /articles/integrating-with-other-software.html.md
-  common-tasks:
-    run-sidekiq-in-a-local-environment: /articles/run-sidekiq-in-a-local-environment.html.md
-    add-remove-or-change-a-mongoid-validation.html.md: /articles/add-remove-or-change-a-mongoid-validation.html.md
-    add-metrics.html.md: /articles/add-metrics.html.md
-    add-a-report.html.md: /articles/add-a-report.html.md
-hosting-workarea:
-  infrastructure.html.md: /articles/infrastructure.html.md
-  configuration-for-hosting.html.md: /articles/configuration-for-hosting.html.md
-application-architecture:
-  prerequisites-and-dependencies.html.md: /articles/prerequisites-and-dependencies.html.md
-  domain-modeling.html.md: /articles/domain-modeling.html.md
-  testing.html.md: /articles/testing.html.md
-  view-models.html.md: /articles/view-models.html.md
-  workers.html.md: /articles/workers.html.md
-  caching:
-    http-caching.html.md: /articles/http-caching.html.md
-    html-fragment-caching.html.md: /articles/html-fragment-caching.html.md
-    low-level-caching.html.md: /articles/low-level-caching.html.md
-  diagrams:
-    commerce-model.html.md: /articles/commerce-model.html.md
-    writing-data.html.md: /articles/writing-data.html.md
-    reading-data.html.md: /articles/reading-data.html.md
-    images-flow.html.md: /articles/images-flow.html.md
-  extension:
-    extension-overview.html.md: /articles/extension-overview.html.md
-    appending.html.md: /articles/appending.html.md
-    decoration.html.md: /articles/decoration.html.md
-    overriding.html.md: /articles/overriding.html.md
-    configuration.html.md: /articles/configuration.html.md
-  misc:
-    application-document.html.md: /articles/application-document.html.md
-    releasable.html.md: /articles/releasable.html.md
-    swappable-list-data-structure.html.md: /articles/swappable-list-data-structure.html.md
-plugins:
-  plugins-overview.html.md: /articles/plugins-overview.html.md
-  create-a-plugin.html.md: /articles/create-a-plugin.html.md
-  maintain-a-plugin.html.md: /articles/maintain-a-plugin.html.md
-  test-if-a-plugin-is-installed.html.md: /articles/test-if-a-plugin-is-installed.html.md
-products:
-  products.html.md: /articles/products.html.md
-  sort-and-exclude-product-options.html.md: /articles/sort-and-exclude-product-options.html.md
-  change-the-storefront-product-pricing-ui.html.md: /articles/change-the-storefront-product-pricing-ui.html.md
-  configure-low-inventory-threshold.html.md: /articles/configure-low-inventory-threshold.html.md
-search:
-  searching.html.md: /articles/searching.html.md
-  storefront-search-features.html.md: /articles/storefront-search-features.html.md
-  storefront-searches.html.md: /articles/storefront-searches.html.md
-  analyze-storefront-search-results.html.md: /articles/analyze-storefront-search-results.html.md
-  change-storefront-search-results.html.md: /articles/change-storefront-search-results.html.md
-  index-storefront-search-documents.html.md: /articles/index-storefront-search-documents.html.md
-  add-remove-sort-and-group-storefront-search-filters.html.md: /articles/add-remove-sort-and-group-storefront-search-filters.html.md
-  change-the-storefront-search-filters-ui.html.md: /articles/change-the-storefront-search-filters-ui.html.md
-cart-and-checkout:
-  checkout.html.md: /articles/checkout.html.md
-  configure-a-payment-gateway.html.md: /articles/configure-a-payment-gateway.html.md
-  integrate-a-payment-gateway.html.md: /articles/integrate-a-payment-gateway.html.md
-  test-a-credit-card-transaction.html.md: /articles/test-a-credit-card-transaction.html.md
-orders:
-  orders.html.md: /articles/orders.html.md
-  orders-and-items.html.md: /articles/orders-and-items.html.md
-  order-life-cycle.html.md: /articles/order-life-cycle.html.md
-  shipping.html.md: /articles/shipping.html.md
-users:
-  configure-logins-and-authentication.html.md: /articles/configure-logins-and-authentication.html.md
-navigation:
-  navigation.html.md: /articles/navigation.html.md
-  navigable.html.md: /articles/navigable.html.md
-content:
-  content.html.md: /articles/content.html.md
-  contentable.html.md: /articles/contentable.html.md
-  add-a-content-area.html.md: /articles/add-a-content-area.html.md
-  add-a-content-block-type.html.md: /articles/add-a-content-block-type.html.md
-  add-system-content.html.md: /articles/add-system-content.html.md
-themes:
-  themes-overview.html.md: /articles/themes-overview.html.md
-  create-a-theme.html.md: /articles/create-a-theme.html.md
-pricing:
-  order-pricing.html.md: /articles/order-pricing.html.md
-  add-or-replace-a-pricing-calculator.html.md: /articles/add-or-replace-a-pricing-calculator.html.md
-  change-the-storefront-product-pricing-ui.html.md: /articles/change-the-storefront-product-pricing-ui.html.md
-  create-a-custom-discount.html.md: /articles/create-a-custom-discount.html.md
-inventory:
-  inventory.html.md: /articles/inventory.html.md
-  integrate-an-inventory-management-system.html.md: /articles/integrate-an-inventory-management-system.html.md
-  define-and-configure-inventory-policies.html.md: /articles/define-and-configure-inventory-policies.html.md
-storefronts:
-  views:
-    views.html.md: /articles/views.html.md
-    style-guides.html.md: /articles/style-guides.html.md
-    create-a-style-guide.html.md: /articles/create-a-style-guide.html.md
-    add-remove-or-change-a-product-template.html.md: /articles/add-remove-or-change-a-product-template.html.md
-    error-pages.html.md: /articles/error-pages.html.md
-    customize-a-helper.html.md: /articles/customize-a-helper.html.md
-    rails-asset-view-helpers.html.md: /articles/rails-asset-view-helpers.html.md
-    system-emails.html.md: /articles/system-emails.html.md
-    configure-contact-form-subjects-list.html.md: /articles/configure-contact-form-subjects-list.html.md
-  stylesheets:
-    css-architectural-overview.html.md: /articles/css-architectural-overview.html.md
-    stylesheets-overview.html.md: /articles/stylesheets-overview.html.md
-    add-stylesheets-through-a-manifest.html.md: /articles/add-stylesheets-through-a-manifest.html.md
-    add-css-through-the-admin-ui.html.md: /articles/add-css-through-the-admin-ui.html.md
-    feature-spec-helper-stylesheet.html.md: /articles/feature-spec-helper-stylesheet.html.md
-  javascripts:
-    javascript-overview.html.md: /articles/javascript-overview.html.md
-    javascript-reference-documentation.html.md: /articles/javascript-reference-documentation.html.md
-    javascript-modules.html.md: /articles/javascript-modules.html.md
-    javascript-templates.html.md: /articles/javascript-templates.html.md
-    access-routes-in-javascript.html.md: /articles/access-routes-in-javascript.html.md
-    analytics-overview.html.md: /articles/analytics-overview.html.md
-    integrate-a-web-analytics-provider.html.md: /articles/integrate-a-web-analytics-provider.html.md
-    add-javascript-through-a-manifest.html.md: /articles/add-javascript-through-a-manifest.html.md
-    add-javascript-through-a-view.html.md: /articles/add-javascript-through-a-view.html.md
-    add-javascript-through-the-admin-ui.html.md: /articles/add-javascript-through-the-admin-ui.html.md
-    featurejs-and-feature-spec-helper.html.md: /articles/featurejs-and-feature-spec-helper.html.md
-    automated-javascript-testing.html.md: /articles/automated-javascript-testing.html.md
-    browser-and-device-support.html.md: /articles/browser-and-device-support.html.md
-    progressive-web-application-support.html.md: /articles/progressive-web-application-support.html.md
-  assets:
-    rails-asset-manifests.html.md: /articles/rails-asset-manifests.html.md
-    configure-asset-types.html.md: /articles/configure-asset-types.html.md
-    configure-product-image-sizes-and-processing.html.md: /articles/configure-product-image-sizes-and-processing.html.md
-    configure-imageoptim.html.md: /articles/configure-imageoptim.html.md
-    favicon-support.html.md: /articles/favicon-support.html.md
-    change-product-placeholder-image.html.md: /articles/change-product-placeholder-image.html.md
-    configure-asset-storage.html.md: /articles/configure-asset-storage.html.md
-internationalization:
-  i18n.html.md: /articles/i18n.html.md
-  configure-locales.html.md: /articles/configure-locales.html.md
-  translate-or-customize-static-content.html.md: /articles/translate-or-customize-static-content.html.md
-  translate-or-customize-message-content.html.md: /articles/translate-or-customize-message-content.html.md
-  translate-administrable-content.html.md: /articles/translate-administrable-content.html.md
-  translate-javascript-content.html.md: /articles/translate-javascript-content.html.md
-contribute:
-  contribute-code.html.md: /articles/contribute-code.html.md
-  contribute-documentation.html.md: /articles/contribute-documentation.html.md
-  documentation.html.md: /articles/documentation.html.md
-  documentation-style-guide.html.md: /articles/documentation-style-guide.html.md
-  report-a-bug.html.md: /articles/report-a-bug.html.md
-  coding-standards:
-    ruby-coding-standards.html.md: /articles/ruby-coding-standards.html.md
-    javascript-coding-standards.html.md: /articles/javascript-coding-standards.html.md
-    stylesheet-coding-standards.html.md: /articles/stylesheet-coding-standards.html.md
-policies:
-  maintenance-policy.html.md: /articles/maintenance-policy.html.md
-  security-policy.html.md: /articles/security-policy.html.md

data/docs/package.json

@@ -1,15 +0,0 @@
-{
-  "name": "workarea",
-  "version": "1.0.0",
-  "main": "index.js",
-  "repository": "ssh://git@stash.tools.weblinc.com:7999/wl/workarea.git",
-  "author": "Curt Howard <choward@workarea.com>",
-  "license": "MIT",
-  "private": true,
-  "devDependencies": {
-    "eslint": "4.19.1",
-    "stylelint": "9.2.1",
-    "stylelint-config-recommended-scss": "3.2.0",
-    "stylelint-scss": "3.1.0"
-  }
-}

data/docs/source/404.html.erb

@@ -1,13 +0,0 @@
----
-body_class: body--flat
----
-
-<div class='section [ white-text align-center ]'>
-  <h1>Definitely Not An Error</h1>
-  <p><strong>Totally not a 404.</strong></p>
-</div>
-
-<p class='section align-center'>
-  <%= image_tag '404.jpg', width: 600 %>
-</p>
-

data/docs/source/articles/access-routes-in-javascript.html.md

@@ -1,33 +0,0 @@
----
-title: Access Routes in JavaScript
-excerpt: Who likes hard coding paths into an application only to see them change? Not me. That's why Rails provides routing helpers for use in Rails views and controllers. To get access to these in JavaScript templates and modules, Workarea provides WORKAREA.ro
----
-
-# Access Routes in JavaScript
-
-Who likes hard coding paths into an application only to see them change? Not me. That's why Rails provides routing helpers for use in Rails views and controllers. To get access to these in JavaScript templates and modules, Workarea provides `WORKAREA.routes.admin` and `WORKAREA.routes.storefront`.
-
-Each property on these objects is a function that returns the corresponding path string.
-
-```
-WORKAREA.routes.storefront.loginPath() // returns "/login"
-```
-
-## How it Works
-
-The functionality is provided by [Js-routes](http://railsware.github.io/js-routes/) and is included in the Admin and Storefront JavaScript manifests.
-
-Admin:
-
-```
-workarea/core/routes
-workarea/admin/routes
-```
-
-Storefront:
-
-```
-workarea/core/routes
-workarea/storefront/routes
-```
-

data/docs/source/articles/add-a-content-area.html.md

@@ -1,169 +0,0 @@
----
-title: Add a Content Area
-excerpt: In this guide, I outline the steps for adding an additional content area and displaying it within the Storefront. My examples will use the Layout content instance. For context, search for this system page in the Admin and then choose to edit its conte
----
-
-# Add a Content Area
-
-In this guide, I outline the steps for adding an additional content area and displaying it within the Storefront. My examples will use the _Layout_ content instance. For context, search for this system page in the Admin and then choose to edit its content.
-
-![Searching for layout system content in the Admin](images/searching-for-layout-system-content-in-admin.png)
-
-Notice this content already has multiple areas (_Header Promo_ and _Footer Navigation_ in the image below).
-
-![Layout content admin with 2 areas](images/layout-content-admin-with-2-areas.png)
-
-My example adds a 3rd area, _utility\_nav_, as shown below.
-
-![Layout content admin with 3 areas](images/layout-content-admin-with-3-areas.png)
-
-And then outputs the blocks for this additional area in the Storefront.
-
-![Utility nav content area in the Storefront](images/utility-nav-area-in-storefront.png)
-
-## Configure Areas
-
-The Admin uses the value of `Workarea.config.content_areas` to determine which areas to display when editing content. The example below shows the data structure of this value—a hash whose keys are strings and whose values are arrays of strings.
-
-```
-Workarea.config.content_areas
-# => {
-# "category" => ["above_results", "below_results"],
-# "checkout" => ["confirmation", "confirmation_signup"],
-# "customization" => ["above_results"],
-# "generic" => ["default"],
-# "layout" => ["header_promo", "footer_navigation"],
-# "search" => ["results", "no_results"]
-# }
-```
-
-You need to manipulate the keys and values in this hash to configure areas. When rendering the content editing UI, an instance of `Workarea::Admin::ContentViewModel` queries this hash looking for:
-
-1. A key matching the content's `slug`<sup><a href="#notes" id="note-1-context">[1]</a></sup>
-2. A key matching the content's contentable's `template`
-3. The key `'generic'`
-
-`Workarea::Admin::ContentViewModel#areas` returns the value (the array of strings) for the first matching key.
-
-The following example should make this more clear.
-
-```
-content = Workarea::Content.for('Layout')
-content_view_model = Workarea::Admin::ContentViewModel.wrap(content)
-
-content_view_model.model.slug
-# => "layout"
-
-content_view_model.contentable.try(:model).try(:template)
-# => nil
-
-content_view_model.areas
-# => ["header_promo", "footer_navigation", "utility_nav"]
-```
-
-Therefore, for my _Layout_ content example, I see the hash key I need to use is `'layout'`, and this key already exists in `Workarea.config.content_areas`, so I need to shovel my additional area onto this existing key.
-
-```
-# config/initializers/content.rb
-
-Workarea.config.content_areas['layout'] << 'utility_nav'
-```
-
-If the key you need does not exist, add the new key and use its value to declare the areas you'd like to include for that content.
-
-## Create Blocks for the Area
-
-Create seeds for one or more content blocks, setting their `area` to the new area you configured. In my example, I create a simple _html_ block, setting its `area` to `'utility_nav'`.
-
-```
-# app/seeds/workarea/system_content_seeds.decorator
-
-module Workarea
-  decorate SystemContentSeeds do
-    def add_layout_content
-      super
-      html = '<span style="background: yellow;">Utility Nav Content</span>'
-      content = Content.for('Layout')
-      content.blocks.create!(
-        area: 'utility_nav',
-        type: 'html',
-        data: { html: html }
-      )
-    end
-  end
-end
-```
-
-## Test Admin
-
-After running seeds, you can see a block saved on the content for the new area.
-
-![Utility nav content area in the Admin](images/utility-nav-area-in-admin.png)
-
-## Render Blocks in Storefront
-
-In the Storefront, use `Workarea::Storefront::DisplayContent#content_blocks_for` to find the blocks for the given content and area.
-
-The view model used for the layout content already includes `Workarea::Storefront::DisplayContent`, so all that's required is a partial to render the blocks.
-
-I add the partial.<sup><a href="#notes" id="note-2-context">[2]</a></sup>
-
-```
-/ app/views/layouts/workarea/storefront/_utility_nav_content.html.haml
-
-- if layout_content.content_blocks_for('utility_nav').present?
-  .grid__cell
-    = render_content_blocks(layout_content.content_blocks_for('utility_nav'))
-```
-
-And append it to the layout.
-
-```
-# config/initializers/appends.rb
-
-Workarea.append_partials(
-  'storefront.utility_nav',
-  'layouts/workarea/storefront/utility_nav_content'
-)
-```
-
-## Test Storefront
-
-You can now test the feature end-to-end in your browser to confirm it is working as expected.
-
-![Utility nav content area in the Storefront](images/utility-nav-area-in-storefront.png)
-
-To catch regressions, write a system test confirming the correct blocks are rendered in the Storefront. I use the following test.
-
-```
-# test/system/workarea/storefront/content_system_test.decorator
-
-module Workarea
-  module Storefront
-    decorate ContentSystemTest do
-      def test_utility_nav_content
-        html = '<span style="background: yellow;">Utility Nav Content</span>'
-        create_content(
-          name: 'layout',
-          blocks: [
-            {
-              area: 'utility_nav',
-              type: 'html',
-              data: { html: html }
-            }
-          ]
-        )
-
-        visit storefront.root_path
-        assert(page.has_content?('Utility Nav Content'))
-      end
-    end
-  end
-end
-```
-
-## Notes
-
-[1] Using `Workarea::Content#slug`, not `Workarea::Navigable#slug`. Navigable slugs are guaranteed to be unique, but content slugs are not. Be aware when adding an area, you may be affecting many content instances.
-
-[2] If my application were already overriding the layout, I would skip the partial and render the blocks directly in the layout file.