Skip to content

Commit

Permalink
Merge pull request #62 from DFE-Digital/integrate-dependabot
Browse files Browse the repository at this point in the history
Integrate dependabot 🤖
  • Loading branch information
peteryates authored Nov 7, 2019
2 parents 0303704 + 5b7361b commit 19126f9
Showing 1 changed file with 21 additions and 14 deletions.
35 changes: 21 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

[![Build Status](https://travis-ci.com/DFE-Digital/govuk_design_system_formbuilder.svg?branch=master)](https://travis-ci.com/DFE-Digital/govuk_design_system_formbuilder)
[![Maintainability](https://api.codeclimate.com/v1/badges/fde73b5dc9476197281b/maintainability)](https://codeclimate.com/github/DFE-Digital/govuk_design_system_formbuilder/maintainability)
[![Test Coverage](https://api.codeclimate.com/v1/badges/fde73b5dc9476197281b/test_coverage)](https://codeclimate.com/github/DFE-Digital/govuk_design_system_formbuilder/test_coverage)
[![Gem Version](https://badge.fury.io/rb/govuk_design_system_formbuilder.svg)](https://badge.fury.io/rb/govuk_design_system_formbuilder)
[![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)
[![Test Coverage](https://api.codeclimate.com/v1/badges/fde73b5dc9476197281b/test_coverage)](https://codeclimate.com/github/DFE-Digital/govuk_design_system_formbuilder/test_coverage)
[![Dependabot Status](https://api.dependabot.com/badges/status?host=github&repo=DFE-Digital/govuk_design_system_formbuilder)](https://dependabot.com)

This gem provides a easy-to-use form builder that generates forms that are
fully-compliant with version 3.3.0 of the [GOV.UK Design System](https://design-system.service.gov.uk/),
Expand All @@ -20,12 +20,20 @@ to text areas or [setting the size and weight of
labels](https://govuk-form-builder.netlify.com/introduction/labels-hints-and-legends/)
on text fields requires only a single argument.

## Documentation 📚

The gem comes with [a full guide](https://govuk-form-builder.netlify.com/) that
covers most aspects of day-to-day use, along with code and output examples. The guide
is generated from the builder itself so it will always be up to date.

If you're still not sure what a form builder is or how it works, don't worry!
[This screencast](https://www.youtube.com/watch?v=PhoFZ0qXAlA) should give you
an idea of what's on offer and [the official guide](https://govuk-form-builder.netlify.com) goes
into a bit more depth on how everything works 😅
an idea of what's on offer and the official guide goes into a bit more depth on
how everything works.

[![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, hints, fieldsets and legends
Expand All @@ -36,10 +44,9 @@ into a bit more depth on how everything works 😅
button collections
* No external dependencies
* An exhaustive test suite
* [Extensive documentation](https://www.rubydoc.info/gems/govuk_design_system_formbuilder/GOVUKDesignSystemFormBuilder/Builder)
* [A full guide](https://govuk-form-builder.netlify.com/)
* [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
Expand All @@ -59,7 +66,7 @@ pre-configured template:
* [DfE Boilerplate](https://github.com/DFE-Digital/govuk-rails-boilerplate)
* [MoJ Rails Template](https://github.com/ministryofjustice/moj_rails_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`:
Expand All @@ -77,7 +84,7 @@ class ApplicationController < ActionController::Base
end
```

Now we can get started! 🎉
Now we can get started!

```slim
= form_for @person do |f|
Expand All @@ -97,7 +104,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 covered by RSpec, to run all the tests first ensure that
all of the development and testing prerequisite gems are installed. At the root
Expand All @@ -113,7 +120,7 @@ Now, if everything was successful, run RSpec:
bundle exec rspec -fd
```

## Contributing
## Contributing 🎁

Bug reports and feature requests are most welcome, please raise an issue or
submit a pull request.
Expand All @@ -122,7 +129,7 @@ Currently we're using [GOVUK Lint](https://github.com/alphagov/govuk-lint) to
ensure code meets the GOV.UK guidelines. Please ensure that any PRs also adhere
to this standard.

## Thanks
## Thanks 👩🏽‍⚖️

This project was inspired by [MoJ's GovukElementsFormBuilder](https://github.com/ministryofjustice/govuk_elements_form_builder),
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.

0 comments on commit 19126f9

Please sign in to comment.