From ccdbf5c0669354c31a641e5a7dedd07e6a153233 Mon Sep 17 00:00:00 2001 From: Matt Marshall Date: Tue, 7 Mar 2023 14:46:13 +0000 Subject: [PATCH 01/17] Added locationScope.csv codelist --- codelists/locationScope.csv | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 codelists/locationScope.csv diff --git a/codelists/locationScope.csv b/codelists/locationScope.csv new file mode 100644 index 00000000..30d3f1d2 --- /dev/null +++ b/codelists/locationScope.csv @@ -0,0 +1,13 @@ +Code,Title,Description +LS0,Global,"The location scope is global." +LS1,Global region,"The location scope is a supranational region or continent. Eg European Union or Africa" +LS2,Multi-country,"The location scope covers multiple countries that don't constitute a global region. Eg France, Portugal and Spain" +LS3,Country,"The location scope covers one country or UK Nation. Eg United Kingdom, Scotland or France" +LS4,Multi-region,"The location scope covers more than subnational administrative region. Eg North of England (North West, North East, Yorkshire & Humber)" +LS5,Region,"The location scope covers one subnational administrative region. Eg North West England" +LS6,County,"The location scope covers one county, province or state. Eg Merseyside" +LS7,Multi-district,"The location scope covers multiple administrative district areas that don't constitute a county, province or state. Eg Liverpool and the Wirral" +LS8,District,"The location scope covers one administrative district area (eg local authority district, unitary authority, metropolitan district, borough, council or district council area). Eg Liverpool" +LS9,Multi-local area,"The location scope covers multiple small areas (eg towns, wards, villages, estates, parks, buildings). Eg" +LS10,Local area,"Location scope covers a single small area (eg town, ward, village, estate, park, building). Eg Kirkdale" +LS11,Location undefined,"The location scope is undefined (eg the funding has no location, such as for online activities with no geographical focus)" From 5733edd1d10873b2a7d2d5b4f11c6652ec1ba28c Mon Sep 17 00:00:00 2001 From: Matt Marshall Date: Tue, 7 Mar 2023 15:02:43 +0000 Subject: [PATCH 02/17] Added Location/locationScope to the standard schema --- schema/360-giving-schema.json | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/schema/360-giving-schema.json b/schema/360-giving-schema.json index 4dc37382..e056757b 100644 --- a/schema/360-giving-schema.json +++ b/schema/360-giving-schema.json @@ -471,6 +471,13 @@ "weight": 1.1, "title": "Name" }, + "locationScope": { + "type": "string", + "title": "Location Scope", + "description": "A code referring to the scope of location applicable to this grant represents. The value for this field should be drawn from the Location Scope codelist", + "codelist": "locationScope.csv", + "openCodelist": false + }, "countryCode": { "type": [ "string", From 8303c14397d3ca1d026d54e89cd521cdc491751e Mon Sep 17 00:00:00 2001 From: Matt Marshall Date: Thu, 9 Mar 2023 10:08:37 +0000 Subject: [PATCH 03/17] Amend locationScope codelist to approved version --- codelists/locationScope.csv | 19 +++++++------------ 1 file changed, 7 insertions(+), 12 deletions(-) diff --git a/codelists/locationScope.csv b/codelists/locationScope.csv index 30d3f1d2..f28d4510 100644 --- a/codelists/locationScope.csv +++ b/codelists/locationScope.csv @@ -1,13 +1,8 @@ Code,Title,Description -LS0,Global,"The location scope is global." -LS1,Global region,"The location scope is a supranational region or continent. Eg European Union or Africa" -LS2,Multi-country,"The location scope covers multiple countries that don't constitute a global region. Eg France, Portugal and Spain" -LS3,Country,"The location scope covers one country or UK Nation. Eg United Kingdom, Scotland or France" -LS4,Multi-region,"The location scope covers more than subnational administrative region. Eg North of England (North West, North East, Yorkshire & Humber)" -LS5,Region,"The location scope covers one subnational administrative region. Eg North West England" -LS6,County,"The location scope covers one county, province or state. Eg Merseyside" -LS7,Multi-district,"The location scope covers multiple administrative district areas that don't constitute a county, province or state. Eg Liverpool and the Wirral" -LS8,District,"The location scope covers one administrative district area (eg local authority district, unitary authority, metropolitan district, borough, council or district council area). Eg Liverpool" -LS9,Multi-local area,"The location scope covers multiple small areas (eg towns, wards, villages, estates, parks, buildings). Eg" -LS10,Local area,"Location scope covers a single small area (eg town, ward, village, estate, park, building). Eg Kirkdale" -LS11,Location undefined,"The location scope is undefined (eg the funding has no location, such as for online activities with no geographical focus)" +GLS010,Global,"The location scope is global." +GLS020,Supranational,"The location scope is a supranational region or continent." +GLS030,National,"The activity scope covers a country, as defined by ISO 3166." +GLS040,Subnational region,"The activity scope covers a first-level subnational administrative area." +GLS050,Local authority,"The activity scope covers a second-level subnational administrative area." +GLS060,Local area,"Location scope covers a small area." +GLS099,Undefined,"The location scope is undefined." From 939be938bdb569adc46511fd5c0a94cc10c69019 Mon Sep 17 00:00:00 2001 From: Matt Marshall Date: Fri, 10 Mar 2023 14:59:15 +0000 Subject: [PATCH 04/17] Moved locationScope field to grant level --- schema/360-giving-schema.json | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/schema/360-giving-schema.json b/schema/360-giving-schema.json index e056757b..a06bd362 100644 --- a/schema/360-giving-schema.json +++ b/schema/360-giving-schema.json @@ -470,14 +470,7 @@ "description": "A name for this location.", "weight": 1.1, "title": "Name" - }, - "locationScope": { - "type": "string", - "title": "Location Scope", - "description": "A code referring to the scope of location applicable to this grant represents. The value for this field should be drawn from the Location Scope codelist", - "codelist": "locationScope.csv", - "openCodelist": false - }, + }, "countryCode": { "type": [ "string", @@ -1309,6 +1302,13 @@ "department" ] }, + "locationScope": { + "type": "string", + "title": "Location Scope", + "description": "A code referring to the scope of location applicable to this grant represents. The value for this field should be drawn from the Location Scope codelist", + "codelist": "locationScope.csv", + "openCodelist": false + }, "grantProgramme": { "items": { "$ref": "#/definitions/GrantProgramme" From 082f36f04008ae7ddcc26deb8a05153a801ea4b4 Mon Sep 17 00:00:00 2001 From: Katherine Duerden Date: Tue, 14 Mar 2023 10:18:19 +0000 Subject: [PATCH 05/17] Update 360-giving-schema.json Updating the field description for location scope --- schema/360-giving-schema.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/schema/360-giving-schema.json b/schema/360-giving-schema.json index a06bd362..8b29c322 100644 --- a/schema/360-giving-schema.json +++ b/schema/360-giving-schema.json @@ -1305,7 +1305,7 @@ "locationScope": { "type": "string", "title": "Location Scope", - "description": "A code referring to the scope of location applicable to this grant represents. The value for this field should be drawn from the Location Scope codelist", + "description": "A code referring to the location scope applicable to this grant. The value for this field should be drawn from the Location Scope codelist.", "codelist": "locationScope.csv", "openCodelist": false }, From 4df57411b4e200f5290efa55c7346e6f1a28e44a Mon Sep 17 00:00:00 2001 From: Katherine Duerden Date: Tue, 14 Mar 2023 10:21:24 +0000 Subject: [PATCH 06/17] Add files via upload --- ...giving-schema-titles-with-meta-tab-2023.xlsx | Bin 0 -> 20807 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 documentation/_static/360-giving-schema-titles-with-meta-tab-2023.xlsx diff --git a/documentation/_static/360-giving-schema-titles-with-meta-tab-2023.xlsx b/documentation/_static/360-giving-schema-titles-with-meta-tab-2023.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..0e14ead4c257df63142a33f436438262d7ad047f GIT binary patch literal 20807 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 literal 0 HcmV?d00001 From 5c50edcc0a15a78a883dc1ed4455940e464a0210 Mon Sep 17 00:00:00 2001 From: Katherine Duerden Date: Tue, 14 Mar 2023 10:24:33 +0000 Subject: [PATCH 07/17] Update reference.md --- documentation/technical/reference.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/technical/reference.md b/documentation/technical/reference.md index e59fb9dd..4424d63b 100644 --- a/documentation/technical/reference.md +++ b/documentation/technical/reference.md @@ -49,7 +49,7 @@ The [Additional fields](additional-fields) section provides details of all other ``` ### Meta Sheet -We also provide a version of the 360Giving Spreadsheet Template with the Metadata template included. The 'Meta' sheet may be used to publish authoritative metadata about the publisher, the file or dataset. The term we use for this is a 'data package'. The 'Meta' sheet includes sections for: +We also provide a version of the 360Giving Spreadsheet Template with the Metadata template included. The 'Meta' sheet may be used to publish authoritative metadata about the publisher, the file or dataset. The term we use for this is a 'data package'. The 'Meta' sheet includes sections for: * The version of the 360Giving Schema used for the file * The title and description of the file @@ -83,6 +83,7 @@ The main grants sheet also includes fields for including codes to indicate: * Grants intended for redistribution * The grant purpose and grant reason for grants to individuals +* The location scope of the grant For further information read our [Guide to codelists](codelists). From 9d0483009b542ca2918358616015b905d7fd4f2a Mon Sep 17 00:00:00 2001 From: Katherine Duerden Date: Tue, 14 Mar 2023 10:42:35 +0000 Subject: [PATCH 08/17] Update codelists.md --- documentation/technical/codelists.md | 57 +++++++++++++++++++++++++--- 1 file changed, 51 insertions(+), 6 deletions(-) diff --git a/documentation/technical/codelists.md b/documentation/technical/codelists.md index d4d5f036..d6bf74fb 100644 --- a/documentation/technical/codelists.md +++ b/documentation/technical/codelists.md @@ -39,11 +39,15 @@ These are intended to be representative, but not comprehensive. When a codelist is open it means that publishers may use a new code outside those in the codelist, if there is no appropriate code for them to use. +```eval_rst +.. _codelists-used: +``` + ## The codelists used in the Standard -There are six codelists used in 360Giving Data Standard. +There are seven codelists used in 360Giving Data Standard. -Two codelists, Currency and Country code are managed by ISO and the four remaining codelists are managed directly by 360Giving. +Two codelists, Currency and Country code are managed by ISO and the five remaining codelists are managed directly by 360Giving. Managed externally @@ -54,6 +58,7 @@ Managed by 360Giving * [GeoCode Type](#geocode-type) * [Regrant Type](#regrant-type) +* [Location Scope](#location-scope) * [Grant to Individuals Purpose](#grant-to-individuals-purpose) * [Grant to Individuals Reason](#grant-to-individuals-reason) @@ -105,25 +110,57 @@ The Geocode Type fields are part of objects which are an array. This means that :widths: auto ``` +```eval_rst +.. _regrant-type: +``` + ### Regrant Type A codelist with values to specify that a grant is intended for redistribution, broken down into seven types of regrant. The codes from this codelist can be published in the field **For Regrant Type**. The **For Regrant Type field** can only be included once with a single code per grant. +For further explanation of how to use the Regrant Type codelist, including examples, read the [360Giving guide to regranting](../guidance/regranting). + ```eval_rst .. csv-table:: :file: ../../codelists/regrantType.csv :header-rows: 1 :widths: auto ``` + +```eval_rst +.. _location-scope: +``` + +### Location Scope + +A codelist with values to specify the grants geographical scope, broken down into seven levels. + +The codes from this codelist can be published in the field **Location Scope**. The **Location Scope field** can only be included once with a single code per grant. + +For further explanation of the location scope codelist, including examples, read the [360Giving guide to location data](../guidance/location-guide). + +```eval_rst +.. csv-table:: + :file: ../../codelists/locationScope.csv + :header-rows: 1 + :widths: auto +``` + +```eval_rst +.. _grant-purpose: +``` + ### Grant to Individuals Purpose A codelist with values to specify the purpose of the grant, in terms of what the funding will be used for. This codelist is intended for use in grants to individual recipients only. The codes from this codelist can be published in the field **To Individuals Details:Grant Purpose**. -As the **To Individuals Details:Grant Purpose** field is an array. This means that multiple iterations of the field can be included when a publisher has more than one code to share per grant. +The **To Individuals Details:Grant Purpose** field is an array. This means that when a grant has more than one purpose it is possible to include multiple codes in this field, separated by a semi-colon. + +**Please note:** This is the only codelist field that is an array. All other fields in the 360Giving Data Standard which use codelists only allow a single code per field. ```eval_rst .. csv-table:: @@ -132,6 +169,10 @@ As the **To Individuals Details:Grant Purpose** field is an array. This means th :widths: auto ``` +```eval_rst +.. _grant-reason: +``` + ### Grant to Individuals Reason A codelist with values to specify the reason that the grant was awarded to the recipient. This codelist is intended for use in grants to individual recipients only. @@ -145,6 +186,10 @@ The codes from this codelist can be published in either of two fields, **To Indi :widths: auto ``` +```eval_rst +.. _codes-how-to: +``` + ## How to use codelists in 360Giving data Only codes from the codelists may be used. Any other code included in the data will result in invalid data. Please be aware that the codes are also case sensitive. Reproduce uppercase and lowercase letters in the codes correctly or the code will not be recognised and your data will be invalid. @@ -178,7 +223,7 @@ Regrant Type 360G-ExampleFdn-001 Contribution to pooled fund for charities supporting local residents 50000 - FRG030 + FRG040 360G-ExampleFdn-002 @@ -217,13 +262,13 @@ Grant To Individuals Codelists 360G-ExampleFdn-001 GTIR010 GTIR030 - GTIP070 + GTIP070;GTIP080 360G-ExampleFdn-002 GTIR010 GTIR100 - GTIP020 + GTIP020;GTIP030;GTIP040 From a8426b140f199162f07068191869c799a5029484 Mon Sep 17 00:00:00 2001 From: Katherine Duerden Date: Tue, 14 Mar 2023 11:01:29 +0000 Subject: [PATCH 09/17] Update location-guide.md --- documentation/guidance/location-guide.md | 98 ++++++++++++++++++++++-- 1 file changed, 93 insertions(+), 5 deletions(-) diff --git a/documentation/guidance/location-guide.md b/documentation/guidance/location-guide.md index e05806de..b19ac859 100644 --- a/documentation/guidance/location-guide.md +++ b/documentation/guidance/location-guide.md @@ -3,19 +3,22 @@ ## Why is location data important? Location data helps users to understand where organisations are based or activities are happening, which helps to build a more complete picture of where funding is going geographically. -Finding out where in the UK grants go is a key question that 360Giving data can be used to answer, but this is only possible when good quality and consistent location data - also known as geodata - is shared. +Finding out where in the UK grants go is a key question that 360Giving data can be used to answer, but this is only possible when good quality and consistent location data – also known as geodata – is shared. -Location is not one of the [ten core fields](https://standard.threesixtygiving.org/en/latest/guidance/plan-the-process/#decide-what-information-to-share), so the 360Giving Data Standard does not require geodata to be included. However, location information is so useful that we do recommend including it whenever possible. When data also includes geographic codes, it makes the data more comparable, and allows the data to be visualised in maps or analysed alongside other datasets. +Location is not one of the [ten core fields](https://standard.threesixtygiving.org/en/latest/guidance/plan-the-process/#decide-what-information-to-share), so the 360Giving Data Standard does not require geodata to be included. However, location information is so useful that we do recommend including it whenever possible. When data also includes geographic codes, it makes the data more comparable, and allows the data to be visualised in maps or analysed alongside other datasets such as Indices of Multiple Deprivation. ## The basics -The 360Giving Data Standard includes a range of ways to describe locations which are split into three types of fields: recipient, funder and beneficiary location. +The 360Giving Data Standard includes a range of ways to describe locations which are split into four types of fields: recipient, funder and beneficiary location, and location scope. - **Recipient location** is where the recipient of a grant is based. - **Funder location** is where the funder of a grant is based. -- **Beneficiary location** is where the funded work is being delivered or the people who access the funded work are based. +- **Beneficiary location** is where the funded work is being delivered or the people who access the funded work are based. +- **Location scope** is the geographical scope of the funded work. Recipient, funder and beneficiary locations can be shared in the form of place names and geographic codes. Recipient and funder locations can also be shared in the form of an address. +Location scope is shared in the form of codes from a codelist. + ### About geographic codes A geographic code, or geocode, is a unique identifier that represents a location or geographic object. These geocodes allow geographic entities to be distinguished from each other and provide a more consistent way to identify a place than using the location name. @@ -27,7 +30,7 @@ Whenever possible, geocodes should be shared by funders publishing on 360Giving **Types of geographic codes** -**Country codes** - two-letter country codes taken from ISO_3166-1_alpha-2. For example the code for the United Kingdom is **GB**, the code for Spain is **ES**. +**Country codes** - two-letter country codes taken from ISO_3166-1_alpha-2 codelist. For example the code for the United Kingdom is **GB**, the code for Spain is **ES**. **ONS codes** - nine character codes managed by the Office for National Statistics which describe a wide range of geographical areas in the UK - including the four nations of the UK, regions in England, local authority areas, electoral wards and Census output areas. @@ -35,6 +38,11 @@ Whenever possible, geocodes should be shared by funders publishing on 360Giving **Latitude and Longitude** - coordinates that indicate a point on the globe, using the World Geodetic System. +### About Location scope codes +Location scope codes are drawn from a codelist developed and managed by 360Giving which provides a short name, description and code for each Location scope value. These codes allow funders to share consistent information about the geographical scope relevant to each grant. For example the code GLS030 can be used to indicate that a grant is intended to have a national impact. + +See our [Codelist guide](.../technical/codelists) for more detailed guidance on what codelists are and how they are used in the 360Giving Data Standard. + ## Recipient organisation location **Recipient location** fields indicate where the grant recipient is based. It could be the location of a main office or branch, whatever is most appropriate for the grant. @@ -307,6 +315,86 @@ Using this method, there should be a row for each location, repeating the grant + +```eval_rst +.. _location-scope-guide: +``` + +## Location scope +The 360Giving Data Standard allows funders to share a **Location scope** for each grant, which describes the geographical scope of the funded work. + +### About the codelist +The codelist includes seven codes that should be used to describe the geographical scope of the funded work. The codes represent the different scopes a grant can have, from global to local areas. There is also a code to indicate when a grant has an undefined location, for example because the funded activity is online with no restrictions to who can access it. + +The location scopes were designed to align with international geographical divisions so the codelist can be applied consistently in all contexts. This means that there are areas grouped into a single scope in the codelist that have more sub-divisions in the UK. + +### Location scope codelist + +```eval_rst +.. csv-table:: + :file: ../../codelists/locationScope.csv + :header-rows: 1 + :widths: auto +``` + +### Explanation of terms + +#### Global +**Code to use:** GLS010 + +**When to use this code:** +Grants which have a global scope, meaning the area where the funded work is being delivered or the people who access the funded work are based all around the world. + +#### Supranational +**Code to use:** GLS020 + +**When to use this code:** +Grants which have a scope which is a supranational region or continent, for example the European Union, North America or Africa. + +#### National +**Code to use:** GLS030 + +**When to use this code:** +Grants which have a scope which covers a country, as defined by ISO 3166, for example the United Kingdom, France or Sierra Leone. + +#### Subnational region +**Code to use:** GLS040 + +**When to use this code:** +Grants which have a scope which covers a first-level subnational administrative area, for example English Regions, Scotland, Wales or Northern Ireland. + +#### Local authority +**Code to use:** GLS050 + +**When to use this code:** +Grants which have a scope which covers a second-level subnational administrative area, for example Districts (England), Principal Areas (Wales), Council Areas (Scotland), Local Government Districts (Northern Ireland), Metropolitan Counties, Non-Metropolitan Counties and Unitary Authorities (England). + +#### Local area +**Code to use:** GLS060 + +**When to use this code:** +Grants which have a scope which covers a small area below local authority level, for example a Ward, MSOA, LSOA, parish, town, village, estate or park. + +#### Undefined +**Code to use:** GLS099 + +**When to use this code:** +Grants which have a scope which is undefined, where location is not relevant, for example for online activities with no geographical focus. + +### Deciding which code to use +The code descriptions and guidance provide examples of which codes to use to categorise grants’ location scope, focused on the UK context. If the grant you want to categorise could fit into more than one scope - for example the grant is funding a local pilot and UK-wide awareness raising campaign, label use the broadest applicable scope GLS030 (National). + +If the grant is funding activity in multiple different areas which are within a single scope – for example funding a project operating in two or more English Regions or activities which are England-wide – the location scope would be GLS040 (Subnational region). + +If you are not sure which category is appropriate for your grant, contact for further guidance. + +### Guidance on using the codelist +To start including **Location scope** codes in 360Giving data, add the Location scope field to the file, and then add the relevant code to your grants wherever possible. + +**Please note:** Only codes from the **Location scope** codelist should be included in the **Location scope** field. Do not add any other codes or text into this field. Be aware that these codes are case sensitive and should be reproduced exactly as they appear in the codelist. + +When it is not possible to provide a Location scope value for a grant, the field must be left blank. + ## Funding organisation location In addition to providing location information for recipients and beneficiaries, the location of the funding organisation itself can be included, either using the address or location fields. From 9007bc497cd46ec003940f3b53bafe6c7316e31e Mon Sep 17 00:00:00 2001 From: Katherine Duerden Date: Tue, 14 Mar 2023 12:53:31 +0000 Subject: [PATCH 10/17] Update location-guide.md --- documentation/guidance/location-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/guidance/location-guide.md b/documentation/guidance/location-guide.md index b19ac859..1f1d63cb 100644 --- a/documentation/guidance/location-guide.md +++ b/documentation/guidance/location-guide.md @@ -41,7 +41,7 @@ Whenever possible, geocodes should be shared by funders publishing on 360Giving ### About Location scope codes Location scope codes are drawn from a codelist developed and managed by 360Giving which provides a short name, description and code for each Location scope value. These codes allow funders to share consistent information about the geographical scope relevant to each grant. For example the code GLS030 can be used to indicate that a grant is intended to have a national impact. -See our [Codelist guide](.../technical/codelists) for more detailed guidance on what codelists are and how they are used in the 360Giving Data Standard. +See our [Codelist guide](../technical/codelists) for more detailed guidance on what codelists are and how they are used in the 360Giving Data Standard. ## Recipient organisation location **Recipient location** fields indicate where the grant recipient is based. It could be the location of a main office or branch, whatever is most appropriate for the grant. From 17373b49b430d1eca4450b50ce99bd04f86ca0e1 Mon Sep 17 00:00:00 2001 From: Katherine Duerden Date: Tue, 14 Mar 2023 13:14:53 +0000 Subject: [PATCH 11/17] Update reference.md --- documentation/technical/reference.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/documentation/technical/reference.md b/documentation/technical/reference.md index 4424d63b..39316b7b 100644 --- a/documentation/technical/reference.md +++ b/documentation/technical/reference.md @@ -267,6 +267,10 @@ Use the other sheets in the Date: Wed, 15 Mar 2023 09:18:45 +0000 Subject: [PATCH 16/17] Added relative link from codelists page to location scope header in guidance --- documentation/technical/codelists.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/technical/codelists.md b/documentation/technical/codelists.md index 1de4b2d7..2ed9a2b6 100644 --- a/documentation/technical/codelists.md +++ b/documentation/technical/codelists.md @@ -139,7 +139,7 @@ A codelist with values to specify a grant's geographical scope, broken down into The codes from this codelist can be published in the field **Location Scope**. The **Location Scope field** can only be included once with a single code per grant. -For further explanation of the location scope codelist, including examples, read the [360Giving guide to location data](../guidance/location-guide). +For further explanation of the location scope codelist, including examples, read the [360Giving guide to location data](../guidance/location-guide#location-scope). ```eval_rst .. csv-table:: From 9c5aeaa8c99a4132294f5779c64493db8635b30b Mon Sep 17 00:00:00 2001 From: Matt Marshall Date: Wed, 15 Mar 2023 09:43:00 +0000 Subject: [PATCH 17/17] Edited relative link in codelists page to location scope --- documentation/technical/codelists.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/technical/codelists.md b/documentation/technical/codelists.md index 2ed9a2b6..5e2f6a4a 100644 --- a/documentation/technical/codelists.md +++ b/documentation/technical/codelists.md @@ -139,7 +139,7 @@ A codelist with values to specify a grant's geographical scope, broken down into The codes from this codelist can be published in the field **Location Scope**. The **Location Scope field** can only be included once with a single code per grant. -For further explanation of the location scope codelist, including examples, read the [360Giving guide to location data](../guidance/location-guide#location-scope). +For further explanation of the location scope codelist, including examples, read the [360Giving guide to location data](../../guidance/location-guide/#location-scope). ```eval_rst .. csv-table::