• Skip to main content
  • Skip to navigation

Cookies on Legislation.gov.uk

The cookies on legislation.gov.uk do two things: they remember any settings you've chosen so you don't have to choose them on every page, and they help us understand how people browse our website, so we can make improvements and fix problems. We need your consent to use some of these cookies.

  • Find out more or set individual cookie preferences
Join the team
Would you like to join the legislation.gov.uk team? We’re currently recruiting for a Data Analyst (Developer).
  • Click here to apply
  • Close

legislation.gov.uk

http://www.nationalarchives.gov.uk
  • Cymraeg
  • Home
  • Explore our collections
  • Research tools
  • Help and guidance
  • What's new
  • About us
  • Search LegislationHide

Search Legislation

Advanced Search

Section Navigation

  • Beta phase: developing a fully functioning tool
  • Discovery and alpha phases completed
  • Technology choices

Back to top

Legislative drafting, amending and publishing tools

Legislation goes through many stages before it becomes law. A range of tools are used to prepare and draft it, amend it during its passage through parliament, publish it on legislation.gov.uk, and archive it. In 2013, a legislative drafting, amending and publishing programme was set up to test the feasibility of a browser-based drafting tool for UK and Scottish legislation that could more effectively support the drafting, amending and publication of legislation from the start to the end of the legislative process.

The programme involves the two Houses of the UK Parliament, the Scottish Parliament; the Office of the Parliamentary Counsel; the Scottish Government’s Parliamentary Counsel Office; and The National Archives. There is a memorandum of understanding between the partners. The partners, either individually or collectively, are responsible for managing all stages of the legislative lifecycle.

Beta phase: developing a fully functioning tool

The project is now in its 'beta' phase, developing a tool that delivers the core functionality for drafting and amending legislation. By the end of the beta phase our aim is to have a product that is viable and ready for drafters and clerks to use.

The project is developing the tool using an Agile method, which supports flexible, iterative and incremental product development, and involves users at every stage.

The work will not stop once the beta product is live. The tool will be developed iteratively, reflecting new needs and user feedback.

Discovery and alpha phases completed

The Discovery phase of the project successfully demonstrated that a browser-based tool was feasible and that suppliers had both the interest and capability to get involved. In the alpha phase we gathered requirements from a range of users, analysed and aligned them and agreed priorities for a minimum viable product. To support this activity, we built wireframes that visualise some of the key requirements, and tested these with users. You can view them on You Tube:

  • Applying Amendments to the Bill Scotland.

  • Applying Amendments to the Bill UK.

  • Drafting Legislation in Scotland.

  • Drafting Legislation in UK.

  • Drafting and Managing Scottish Amendments.

  • Drafting and Managing UK Amendments.

  • Drafting SIs and SSIs.

  • Reviewing Amendments – Creating Lists – Recording Outcomes in Scotland.

  • Reviewing Amendments – Creating Lists – Recording Outcomes in UK.

The wireframes do not show what the final drafting and amending tool will look like, but they give a clear sense of its potential and flexibility.

Technology choices

As a consequence of our discovery work, including extensive consultation and research with experts, we have made some technology choices. We are looking to build a drafting tool that is predominantly based on leading open source technologies and open standards – the Akoma Ntoso XML markup language, the eXist XML database, the MEAN stack of JavaScript frameworks (Mongo, Express, Angular, Node) and a customised XML/HTML editor. We believe this mixture of technologies provides the best chances of success, to tackle the unique challenges of drafting and amending legislation documents.

We have extended the legislation.gov.uk API to support Akoma Ntoso. You can access any piece of legislation in this format, by adding /data.akn to the URL. For example, Budget (Scotland) Act 2015 can be viewed in this format at: http://www.legislation.gov.uk/asp/2015/2/enacted/data.akn .

We have also serialised this Akoma Ntoso XML as HTML5 for online presentation. You can access this by adding /data.html to the URL. For example: http://www.legislation.gov.uk/asp/2015/2/enacted/data.html

If you would like more information on the technology choices we have made, you can read our Technology Choices Factsheet.

  • New site design
  • Help
  • About us
  • Site map
  • Accessibility
  • Contact us
  • Privacy notice
  • Cookies

OGL logoAll content is available under the Open Government Licence v3.0 except where otherwise stated. This site additionally contains content derived from EUR-Lex, reused under the terms of the Commission Decision 2011/833/EU on the reuse of documents from the EU institutions. For more information see the EUR-Lex public statement on re-use.

© Crown and database right