Add some links to platforms that use the form builder

README.md

@@ -14,7 +14,7 @@ This library provides an easy-to-use form builder for the [GOV.UK Design System]
 
 It is intended to make creating forms **quick**, **easy** and **familiar** for Ruby on Rails developers.
 
-## Documentation 📚
+## Documentation
 
 The gem comes with [a full guide](https://govuk-form-builder.netlify.app/) that
 covers most aspects of day-to-day use, along with code and output examples. The
@@ -23,7 +23,7 @@ be up to date.
 
 [![Netlify Status](https://api.netlify.com/api/v1/badges/d4c50b8d-6ca3-4797-9ab3-6e0731c72b44/deploy-status)](https://app.netlify.com/sites/govuk-form-builder/deploys)
 
-## What's included 🧳
+## What's included
 
 * 100% compatibility with the GOV.UK Design System
 * Full control of labels, legends, hints, captions and fieldsets
@@ -38,7 +38,7 @@ be up to date.
 * An exhaustive test suite
 * [Extensive technical documentation](https://www.rubydoc.info/gems/govuk_design_system_formbuilder/GOVUKDesignSystemFormBuilder/Builder)
 
-## Installation 🏗
+## Installation
 
 You can install the form builder gem by running the `gem install
 govuk_design_system_formbuilder` or by adding the following line
@@ -58,7 +58,7 @@ pre-configured template:
 * [DfE Rails Template](https://github.com/DFE-Digital/rails-template)
 * [DEFRA Ruby Template](https://github.com/DEFRA/defra-ruby-template)
 
-## Setup 🔧
+## Setup
 
 To use the form builder in an ad hoc basis you can specify it as an argument to
 `form_for` or `form_with`. These examples are written in [Slim](https://github.com/slim-template/slim) but
@@ -97,7 +97,7 @@ Now we can get started!
   = f.govuk_submit 'Away we go!'
 ```
 
-## Developing and running the tests 👨🏻‍🏭
+## Developing and running the tests
 
 The form builder is tested with RSpec. To run all the tests first ensure that
 the development and testing prerequisite gems are installed. At the root of a
@@ -113,7 +113,7 @@ Now, if everything was successful, run RSpec:
 bundle exec rspec
 ```
 
-## Contributing 📦
+## Contributing
 
 Bug reports and feature requests are most welcome, please raise an issue or
 submit a pull request.
@@ -143,7 +143,12 @@ here are a few from the <abbr title="Department for Education">DfE</abbr>, <abbr
  * [Trade Tariff duty calculator](https://www.github.com/trade-tariff/trade-tariff-duty-calculator)
  * [Report your official development assistance](https://www.github.com/UKGovernmentBEIS/beis-report-official-development-assistance)
 
-## Thanks 👩🏽‍⚖️
+## Form building services using this library
+
+* [MoJ Forms](https://moj-forms.service.justice.gov.uk/)
+* [GOV.UK Forms](https://www.forms.service.gov.uk/)
+
+## Thanks
 
 This project was inspired by [Ministry of Justice's GovukElementsFormBuilder](https://github.com/ministryofjustice/govuk_elements_form_builder),
 but is leaner, more modular and written in a more idiomatic style.

guide/layouts/partials/links.slim

@@ -8,6 +8,12 @@
         | Every component of the form builder is designed to produce accessible
           HTML that meet all of the design system’s requirements without having
           to spend time reinventing the wheel.
+      p.govuk-inset-text
+        | This tool is aimed at developers. If you need a service that
+          lets you build forms without writing any code, you can
+          use one of the platforms that wrap this library like
+          #{link_to_in_new_tab("GOV.UK Forms", govuk_forms_link).html_safe} or
+          #{link_to_in_new_tab("MoJ Forms", moj_forms_link).html_safe}.
 
   nav class="govuk-grid-row govuk-!-margin-bottom-4"
     .govuk-grid-column-one-third
@@ -27,7 +33,6 @@
         li== link_to 'Injecting content', '/building-blocks/injecting-content'
         li== link_to 'Fieldsets', '/building-blocks/fieldsets'
         li== link_to 'Localisation', '/building-blocks/localisation'
-        / li== link_to 'Other design systems', '/building-blocks/other-design-systems'
 
     .govuk-grid-column-one-third
       h2.govuk-heading-m Form elements

guide/lib/helpers/formatters.rb

@@ -4,6 +4,12 @@ def block_has_content?(block)
       block.call
     end
 
+    def link_to_in_new_tab(*args, **kwargs, &block)
+      new_tab_args = { rel: "noreferrer noopener", target: "_blank" }
+
+      link_to(*args, **new_tab_args.merge(kwargs), &block)
+    end
+
     def format_slim(raw, **args)
       # FIXME: not sure why when we're several
       #        blocks deep we need to unescape more

guide/lib/helpers/link_helpers.rb

@@ -105,5 +105,13 @@ def rails_option_groups_from_collection_for_select_link
     def rails_options_from_collection_for_select_link
       'https://edgeapi.rubyonrails.org/classes/ActionView/Helpers/FormOptionsHelper.html#method-i-options_from_collection_for_select'
     end
+
+    def govuk_forms_link
+      "https://www.forms.service.gov.uk/"
+    end
+
+    def moj_forms_link
+      "https://moj-forms.service.justice.gov.uk/"
+    end
   end
 end