gdmp-translated-standards

Repository for versions of GDS Standards and guidance translated and/ or internationalised

View the Project on GitHub alphagov/gdmp-translated-standards

Technology Code of Practice

This document is an adaptation of guidance used to procure technology in the UK.

The Technology Code of Practice is a set of criteria to help government design, build and buy technology.

Using the Technology Code of Practice

You should use the Technology Code of Practice for all of your technology projects or programmes. Consider each point and align your project or programme to them. You’ll get the most benefit by aligning your organisation’s technology and business strategies to the Technology Code of Practice.

Following the Technology Code of Practice will help you introduce or update technology so that it:

The Technology Code of Practice contains guidance and case studies to help you migrate from legacy infrastructure and manage the full lifecycle of your technology.

The Technology Code of Practice can be used as part of a government spend control process.

1. Define user needs

Understand your users and their needs. Develop knowledge of your users and what that means for your technology project or programme.

To meet point 1 of the Technology Code of Practice you must show you understand your users and their needs.

You may have to explain how you’re doing this as part of a spend control process.

How user research will help your programme

Doing user research will help your technology project or programme by identifying:

User research can also:

Find out more about:

2. Make things accessible and inclusive

Make sure your technology, infrastructure and systems are accessible and inclusive for all users.

To meet point 2 of the Technology Code of Practice (TCoP) your plan or design must show how you’re making technology inclusive.

If you’re going through a spend control process you should explain how you’re meeting point 2 or any limitations you’ve encountered.

How making things accessible and inclusive will help your programme

Your technology project or programme will benefit from:

How to build accessible technology

When building IT infrastructure and systems make sure you consider accessibility from the start of your project or programme. Do research with users who have a range of abilities and decide on your accessibility requirements. Doing this means you can make sure that:

For example, you should consider:

If you’re also building or buying technology to provide a service over the web, read the guidance on making your service accessible.

How to buy accessible technology

When you’re buying a technology product you buy something that’s as accessible as possible.

How to supply accessible technology

If you’re supplying a technology product to the public sector, you might need to make a statement about how that product meets accessibility standards.

Web Content Accessibility Guidelines (WCAG 2.1) is an international standard that covers websites and digital services. To make your service accessible should aim to meet level AA of the WCAG 2.1 as a minimum.

Part of making your service accessible is ensuring you procure web technologies and other types of technology, including hardware and non-web software in the right way. The UK follows standards based on WCAG 2.1 to achieve this, an example of which is the EU standards EN 301 549.

Some best practice about supplying accessible technology include:

You should be accurate about how far your product meets accessibility standards

Meeting the WCAG 2.1 standard for websites and digital services

Read the guidance on understanding WCAG 2.1.

You might want to consider paying to get your product audited against WCAG 2.1 by an accessibility expert.

Related guides

3. Be open and use open source

Publish your code and use open source software to improve transparency, flexibility and accountability.

To meet point 3 of the Technology Code of Practice your plan or design must show you’ve considered using open source and publishing your code openly.

If you’re going through a spend control process you should explain how you’re meeting point 3 or any limitations you’ve encountered.

How open source differs to open standards

Open source is a way of developing and distributing software. The code is often written collaboratively, and it can be downloaded, used and changed by anyone.

Open standards are common rules that allow any user to create compatible and consistent products, processes and services. They are designed collaboratively, are publicly available, and free or low cost.

How using open source will help your programme

Your technology project or programme could benefit from:

Be aware that open source software is not completely free, so take into account the total cost of migrating, including exit and transition costs.

How being open will help your programme

Publishing your code and data from the beginning of your technology project or programme will encourage:

Publishing code when building your technology

If your technology project or programme includes code in its development, refer to the Service Manual section on making source code open and reusable. There are times when it’s acceptable for code to be closed source. For example, keys and credentials, algorithms used to detect fraud and unreleased policy.

Buying technology that uses open source

Give equal consideration to open source software when you choose technology.

The following questions are some of the points to consider when choosing technology and your preferred open source solution. These questions can also help if you are evaluating whether you want a proprietary or open source solution.

  1. Does the solution do what you need it to do?
  2. Does the solution meet the needs of your end users?
  3. What are the solution’s initial and ongoing costs?
  4. Will the staff need training or will expert users need to be employed to manage the solution?

  5. If the solution is open source, how widely is the code already adopted? How mature is it?

  6. Does the solution offer the level of support needed?

  7. How well is the solution maintained and is there evidence of further development?
  8. How reliable is the solution? This is hard to measure, but one way is to assess it by looking at its maturity.

  9. How well does the solution perform? Can you analyse performance data or reviews?
  10. How well will the solution scale to meet your needs?

  11. Does the solution’s security meet your needs and does it have regular security patches?

  12. Is the solution flexible? You can customise the solution to fully meet your needs but be aware this can make future updates and security patches hard to implement.
  13. Will the solution work with your other technology?

  14. Is the solution’s licence acceptable to your organisation’s business requirements? Are there any restrictions or gaps that would cause issues? Are there any restrictions or gaps that would cause issues?

  15. Is the solution’s warranty acceptable and is there an option to buy one?

4. Make use of open standards

Build technology that uses open standards to ensure your technology works and communicates with other technology, and can easily be upgraded and expanded.

To meet point 4 of the Technology Code of Practice your plan or design must show you’ve considered using open standards and data.

If you’re going through a spend control process you should explain how you’re meeting point 4 or any limitations you’ve encountered.

How open source differs to open standards

Open source is a way of developing and distributing software. The code is often written collaboratively, and it can be downloaded, used and changed by anyone.

Open standards are common rules that allow any user to create compatible and consistent products, processes and services. They are designed collaboratively, are publicly available, and free or low cost

How open standards help your programme

You can use open standards for individual parts of your project or programme. Using open standards increases interoperability and means you:

Building technology that uses open standards

You can make your technology project or programme more flexible and interoperable by:

Buying technology that uses open standards

When you’re buying a technology product make sure you to request that open standards be used by the supplier comply with the definition of an open standard as described in the ‘Open Standards principles’.

Supplying technology that uses open standards

Suppliers should be aware of the open standards that should be used in government. Wherever possible, suppliers should make these open standards part of their product offering, or offer products that are compatible with these open standards.

5. Use cloud first

Consider using public cloud solutions first before considering other options .

To meet point 5 of the Technology Code of Practice your plan or design must show you have considered using the public cloud. The UK uses a cloud first policy to inform this approach

If you’re going through a spend control process you should explain how you’re meeting point 5 or any limitations you’ve encountered.

Summary description of cloud computing

Cloud computing is a way of storing and retrieving data and software over the internet. The 3 main service areas are:

How adopting cloud first will help your programme

You can use cloud computing to treat compute, network, storage and power as utilities. This approach is beneficial because:

For greater detail on the benefits of using cloud, you can read the blog posts on Why we use the cloud: security and efficiency and Why we use the cloud: supporting services

Exceptions

In some cases you may wish to use an alternative to the cloud. You should only do so if you can demonste your chosen service represents the best value for money if selecting an alternative to public cloud. You should’nt also show you’ve allowed for flexibility by being able to change the system and reduce costs over time.

Read how the Department for Transport is using cloud technology.

Using the cloud securely

The main guidance for securing your network, services and data in the cloud is:

6. Make things secure

Keep systems and data safe with the appropriate level of security.

To meet point 6 of the Technology Code of Practice your plan or design must show how you are securing data and systems.

If you’re going through a spend control process you should explain how you’re meeting point 6 or any limitations you’ve encountered.

How meeting security requirements helps your programme

By securing your technology you will:

Assess your security and resources

You must consider security from the start of your technology programme, and for your service as a whole. Before you start, consider the following questions:

  1. What security risks does your programme have?

  2. Will your programme use or collect sensitive data? 3. How will your programme’s security interact with other systems?

  3. How will your programme’s security integrate with your organisation’s departmental security and processes?

  4. How will your programme’s security meet cyber security standards. For example, the UK uses theMinimum Cyber Security standard

  5. Do you have access to the security expertise and skills you need?

  6. How will you source the security expertise and skills you need?

  7. What changes to your organisation’s security documentation and processes will your programme need?

  8. How will you provide appropriate security assurance, both throughout the duration of the programme and for its product or service?

Each organisation’s security resources will depend on their budget, risk appetite and what information and services they’re handling. Discuss your programme’s security requirements with the team or individual responsible for security in your organisation. As part of this you should:

Once you have identified your programme security risks, you should integrate these into your programme plan, and include:

Use proportionate security for your technology

Choose proportionate security to control and monitor your technology programme. Security should protect your information technology and digital services, and enable users to access the data they need for their work.

You should consider the security of any tools you might use to implement and maintain your technology programme.

As you implement your technology programme you should continually review your security, and make sure that you’re mitigating or accepting the security risks that you’ve identified.

Network and infrastructure security Malicious access is always a risk. Plan how to:

Make sure you have processes and controls in place to collect, record, protect, and analyse information about any attacks and use this data to improve defences. It would be helpful for you to:

Data security

When platforms have internet access and hold real data, threat actors or attackers may try to steal or alter the data. Also, there is a greater risk of an accidental real data leak. Some guides used in the UK which can help with this include:

You should integrate security controls and monitoring with the data and network flows using proportionate risk analysis.

Service security

You can find information on securing your services in point 9 of the Service Standard - Create a secure service which protects users’ privacy

Cloud security

Ensuring cloud security is critical. In the UK helpful guidance on this includes thee Cloud Security Principles, the Cloud security guidance and the Risk management guidance NCSC.

Whether you’re procuring software as a service (SaaS) or developing your own solution for a platform of tools and services, you should consider puting in place mitigations such as:

Providing assurance

You will find it helpful to set up assurance mechanisms to monitor your programme security, identify potential risks, and provide confidence to senior leaders and stakeholders about the effectiveness of your security controls.

Continually evaluate your security controls to make sure they:

Use continuous improvement planning to manage and update security

You should provide ongoing assurance of your programme’s security and consider how it integrates with the rest of your organisation’s security. You should discuss this with the team or individual responsible for security in your organisation.

You should consider:

Continuous improvement planning is helpful for your business-as-usual processes This will give you regular opportunities to review and improve your security as needed. The review process will also make sure that your security still meets user needs and evolving technology. The UK applies guidance for continuous improvement planning, which you may find helpful.

7. Make privacy integral

Make sure users rights are protected by integrating privacy as an essential part of your system.

To meet point 7 of the Technology Code of Practice your plan or design must show how you are using privacy by design.

You may have to explain how you’re doing this as part of a spend control process.

Delivering privacy by design

Valuing the privacy of users, and being clear with them how their data is used is critical for:

To ensure trust, you should ideally tell users exactly how their data is going to be used when you collect it from them, and dispose of the data you collect once you no longer have a legitimate use for it. You should always take steps to ensure the data you collect is secure. Following this practice of privacy by design when building your service will also likely help you comply with relevant data privacy laws.

Maintaining the privacy of citizens’ personal data includes security. Privacy also includes how citizens:

How privacy by design will help your programme

Your technology project or programme will benefit from:

How to embed privacy by design

The following questions are useful when considering data and privacy:

  1. Will the project or programme involve the collection of new information about

individuals?

  1. Will individuals have to provide information about themselves to the project or

Programme?

  1. Will information about individuals be disclosed to organisations or people who have

not previously had routine access to the information?

  1. Are you using information about individuals for a purpose it is not currently used for,

or in a way it is not currently used?

  1. Does the project or programme involve you using new technology that might be perceived as being privacy intrusive? For example, the use of biometrics or facial recognition.

  2. Will the project or programme result in you making decisions or taking action against individuals in ways that can have a significant impact on them?

  3. Is the information about individuals of a kind particularly likely to raise privacy concerns or expectations? For example, health records, criminal records or other information that people would consider to be private.

  4. Will the project or programme require you to contact individuals in ways that they may find intrusive?

8. Share, reuse and collaborate

Avoid duplicating effort and unnecessary costs by collaborating across government and sharing and reusing technology, data, and services.

To meet Point 8 of the Technology Code of Practice you should consider whether your project or programme can share and reuse technology.

If you’re going through a spend control process you should explain how you’re meeting point 8 or any limitations you’ve encountered.

Benefits of sharing and reusing

Before you start your technology project or programme, consider whether sharing your work could benefit other teams in your organisation, or other government organisations. By sharing your work you can benefit from:

By reusing existing technology you can benefit from:

How to share technology and collaborate across government

It’s easier and cheaper to plan how you will share your technology solution from the start of your project or programme. Clear documentation will help your project or programme, and make it easier for you to share your work.

Government APIs The API technical and data standards and API design guidance can help your organisation provide data for government services in a consistent and shareable way. You can also use or contribute to the government’s API catalogue.

Government code

You should consider publishing your code in the open and use open source technology. Some examples of open government code from the UK include:

9. Integrate and adapt technology

Your technology should work with existing technologies, processes and infrastructure in your organisation, and adapt to future demands.

To meet point 9 of the Technology Code of Practice your plans must show how your technology project or programme integrates into your organisation.

If you’re going through a spend control process you should explain how you’re doing this.

How integration helps your programme

Good integration means making sure your new technology works with legacy solutions without limiting your ability to adapt to future demands or upgrade systems.

Your programme will benefit from:

Fitting new technology into your organisation

Each organisation’s technology and infrastructure will have services and issues that are unique. But there are some common elements to consider when fitting new technology into your current or legacy system, including:

Read how the Department for Transport’s Chief Architect has created a Digital Design Authority to help integrate new technology with their current technology.

To optimise systems integration consider:

If you have chosen to use a systems integrator you should make sure they meet all of your requirements.

Meeting user needs with emerging technologies

A number of government organisations are using or investigating emerging technologies. If you’re thinking about introducing emerging technology to your infrastructure, you should make sure it meets user needs. You’ll need to investigate alternative mature technology solutions thoroughly to check if this is the case.

Your emerging technology programme will also benefit from checking:

You can find guidance on choosing technology for services here, including how to adopt new technology.

Examples of emerging technologies around government

‘Emerging technologies’ is a broad term for a range of tools and techniques that are at different stages of development. Examples of emerging technology include:

But although emerging technologies are sometimes categorised together, some are more mature than others.

Several UK departments are already using artificial intelligence or machine learning in different ways. For example, GDS is using machine learning to process large amounts of data to aid human decision-making. And Oxford City Council is leading a group of local authorities in a joint discovery on how chatbots and AI might help to solve service design problems.

If you are considering using artificial intelligence, read the guidance on using artificial intelligence in the public sector.

Bodies like the Food Standards Agency and Land Registry are undertaking discoveries into DLT to understand if the technology is suitable for public sector use. DLT offers great promise, but it is unclear where the technology might offer government significant improvements over other types of infrastructure.

Some government bodies are also funding research into quantum computing. This technology is in the theoretical phase and the government is unlikely to use this technology in the short term.

10. Make better use of data

Use data more effectively by improving your technology, infrastructure and processes.

To meet point 10 of the Technology Code of Practice your plans must show you’ve considered the data lifecycle.

If you’re going through a spend control process you should explain how you’re meeting point 10 or any limitations you’ve encountered.

How improving data use will help your programme

Improve how you use and manage data to:

Follow the required data regulations

To ensure user trust you should ideally tell them exactly how their data is going to be used when you collect it from them, and dispose of the data you collect once you no longer have a legitimate use for it. You should always take steps to ensure the data you collect is secure. Following this practice of privacy by design when building your service will also likely help you comply with relevant data privacy laws.

Some guides from the UK which you may find helpful in this include

How your programme can make better use of data

Here are some best practices for collecting, storing, analysing and sharing data from other departments, other governments and other sectors.

Getting the right technology, processes and training

Make sure your data collection practices, data tools and infrastructure meet user needs, are scalable and encourage collaboration. Also consider the following questions:

  1. Do you have the right tools to capture and store the data you need?

  2. Are your processes for data collection ethical and transparent?

  3. Are your processes for data collection secure?

  4. Have you chosen the most efficient data collection processes for the data you need?

  5. Do staff have the skills they need or do you need to arrange training?

  6. Does the way you do data entry ensure data accuracy and trust?

  7. Do you standardise the data after collection so it is easier to create interoperable Data?

  8. Does the data have an assigned owner?

  9. Do you need to anonymise your data to make it non-attributable?

Storing and maintaining your data

Make sure you secure your data tools and infrastructure and hold it for specified purposes to comply with data laws

You should also make sure that newly collected data is easily accessible to APIs for future use. Consider the following questions:

  1. Where is your data stored and does the location meet your organisation’s security requirements and meet guidance on your country (for reference UK Guidance: moving data outside)

  2. Have you considered whether to use cloud technology, data centres such, or on-premise networks?

  3. Does your technology meet the required standards and is it scalable/flexible?

  4. Is your technology set up according to data security best practice?

  5. Does any of your data have protected characteristics that needs encryption or more secure storage?

  6. Are your security processes regularly reviewed and updated?

  7. Do you use Open Standards and clear processes to make sure you can analyse, and where appropriate, share data with other departments?

  8. Do your processes make it easy to keep data current and accurate?

  9. Does your data have clear audit trails that clearly show how individual data records are accessed and updated?

  10. Do you have the right amount of storage for the volume of data your organisation processes, or a way to scale your storage as data usage changes?

Using and publishing your data

Make sure you’re using data efficiently and based only on user needs, for example the UK uses a Data Ethics Framework. Consider the following questions regarding data use:

  1. Where will you publish your data?

  2. How can you share your non-sensitive data to minimise duplicate data sets?

  3. How can you choose data tools and infrastructure that keep pace with user needs, are scalable and encourage collaboration?

  4. Do you use open standards and patterns to make it is easier to analyse data, and where appropriate, share it with other departments?

You can use scientific analysis and conduct A/B testing to help make data driven decisions. For example, how the Government Digital Service used data to improve content and user journeys on GOV.UK.

When you’re publishing data, make it open by default and follow the Open Data Principles. Also consider these questions:

  1. Do you have processes and safeguards to check what data you publish and how you keep your sensitive data safe?

  2. Do you follow a code of practice for data sharing? The UK follows the Information Commissioner’s Office Code of Practice for data sharing

  3. Do you use the API technical and data standards and the government’s API catalogue?

Archiving, deleting or renewing data

You should check where your data is in its lifecycle and only keep data for as long as necessary. You should consider these questions:

  1. Is there a process in place to decide when it is right for your organisation to retire or archive data?

  2. Is there a process in place to decide what data you can delete and replace with new or updated data?

  3. Is there a process in place to ensure individuals data is deleted on their request to ensure your service is delivering privacy by design data on their request?

  4. Do you have a process for securely deleting data when it’s no longer needed?

Policies and guidance used in the UK includes:

Indication of what to include and what to leave:

11. Define your purchasing strategy

Your purchasing strategy must show you’ve considered commercial and technology aspects, and contractual limitations.

To meet point 11 of the Technology Code of Practice your plan or design must show your sourcing strategy and how your contracts meet government rules and guidelines.

You should to explain how you’re doing this as part of a spend control process.

How defining your purchasing strategy will help your project

Your technology project or programme will benefit from:

Commercial approach

Your sourcing strategy must demonstrate that you have a thorough understanding of the commercial undertakings required to deliver, use and manage your programme. You should plan how to manage multiple suppliers, where that structure is appropriate for the organisation’s operating model, and when they’re working as part of the same delivery teams. This includes:

Technology considerations

Your sourcing strategy must consider technology approaches that will encourage the future use of your product or service, including:

Use common government sourcing routes

Find appropriate services and suppliers to avoid lengthy and expensive procurement processes. Work with your departmental commercial team to understand which route is most appropriate.

Follow government contractual guidelines

Contracts should:

Contracts should:

Remember that:

12. Meet the Service Standard

If you’re building a service as part of your technology project or programme you will also need to meet the Service Standard.

Who to contact for help

GDMPglobal.digitalmarketplace@digital.cabinet-office.gov.uk