From 58efdcac966febb13ad961f5b021917e0de8aac0 Mon Sep 17 00:00:00 2001 From: Anthony Lukach Date: Thu, 8 Oct 2026 18:40:50 -0600 Subject: [PATCH 1/3] docs: suggest a tag that isn't on the list Users can now suggest a new tag from the tag picker (source-cooperative/source.coop feat/tag-suggestions), so describe that instead of emailing. Co-Authored-By: Claude Opus 5.5 --- docs/using-source/create-a-data-product.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/using-source/create-a-data-product.md b/docs/using-source/create-a-data-product.md index c1ec457..5145c20 100644 --- a/docs/using-source/create-a-data-product.md +++ b/docs/using-source/create-a-data-product.md @@ -16,7 +16,7 @@ Data products can be owned by an organization or an individual. You will see a d - - **Product ID**: 3–39 characters, alphanumeric and hyphens only (A–Z, 0–9, -). No consecutive hyphens, and it cannot start or end with a hyphen. The identifier appears in the URL. - **Description**: Optional; maximum 500 characters. Use it for a short overview; put detailed documentation in the README. - **Visibility**: New data products are created **Unlisted** (not shown in search). When ready to publish, open the data product page, click the gear icon, and set the state to **Listed**. -- **Tags**: Optional. Click **Add tags** (or **Edit tags**) to tick tags from Source's list, using the box at the top to filter it. Each tag you choose appears as a chip you can remove. Tags help others discover your data. If the tag you need isn't on the list, contact `hello@source.coop`. +- **Tags**: Optional. Click **Add tags** (or **Edit tags**) to tick tags from Source's list, using the box at the top to filter it. Each tag you choose appears as a chip you can remove. Tags help others discover your data. If the tag you need isn't on the list, type it in the filter box and click **Suggest**. The tag goes on your data product straight away, marked *pending*, and the Source team reviews it: it is approved, swapped for an existing tag that means the same thing, or removed. You can have up to five suggestions awaiting review at once. - **Data Connection**: Choose where the product's data lives. By default it uses Source-managed storage. If you've set up [Bring Your Own Bucket](/bring-your-own-bucket), select the data connection for your bucket instead. If you don't have a strong preference, choose a connection in the `us-west-2` region—this is where most Source data lives, and colocating keeps access fast and avoids cross-region transfer costs. You can bring an existing S3 bucket you own rather than storing data on Source. This is a beta feature—see [Bring Your Own Bucket](/bring-your-own-bucket) to set up a data connection before creating the product, then select it here. From 15008929d1795fbaf32095bf16cc5e4f43e4e39c Mon Sep 17 00:00:00 2001 From: Anthony Lukach Date: Mon, 19 Oct 2026 11:58:53 -0700 Subject: [PATCH 2/3] docs: pending tags show only in settings until reviewed Suggested tags no longer appear publicly before an admin approves them (source-cooperative/source.coop#648). Co-Authored-By: Claude Opus 5.5 --- docs/using-source/create-a-data-product.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/using-source/create-a-data-product.md b/docs/using-source/create-a-data-product.md index 5145c20..c357127 100644 --- a/docs/using-source/create-a-data-product.md +++ b/docs/using-source/create-a-data-product.md @@ -16,7 +16,7 @@ Data products can be owned by an organization or an individual. You will see a d - - **Product ID**: 3–39 characters, alphanumeric and hyphens only (A–Z, 0–9, -). No consecutive hyphens, and it cannot start or end with a hyphen. The identifier appears in the URL. - **Description**: Optional; maximum 500 characters. Use it for a short overview; put detailed documentation in the README. - **Visibility**: New data products are created **Unlisted** (not shown in search). When ready to publish, open the data product page, click the gear icon, and set the state to **Listed**. -- **Tags**: Optional. Click **Add tags** (or **Edit tags**) to tick tags from Source's list, using the box at the top to filter it. Each tag you choose appears as a chip you can remove. Tags help others discover your data. If the tag you need isn't on the list, type it in the filter box and click **Suggest**. The tag goes on your data product straight away, marked *pending*, and the Source team reviews it: it is approved, swapped for an existing tag that means the same thing, or removed. You can have up to five suggestions awaiting review at once. +- **Tags**: Optional. Click **Add tags** (or **Edit tags**) to tick tags from Source's list, using the box at the top to filter it. Each tag you choose appears as a chip you can remove. Tags help others discover your data. If the tag you need isn't on the list, type it in the filter box and click **Suggest**. The tag is added to your data product's settings straight away, marked *pending*, but nobody else sees it until the Source team reviews it. The team approves it, swaps it for an existing tag that means the same thing, or removes it. You can have up to five suggestions awaiting review at once. - **Data Connection**: Choose where the product's data lives. By default it uses Source-managed storage. If you've set up [Bring Your Own Bucket](/bring-your-own-bucket), select the data connection for your bucket instead. If you don't have a strong preference, choose a connection in the `us-west-2` region—this is where most Source data lives, and colocating keeps access fast and avoids cross-region transfer costs. You can bring an existing S3 bucket you own rather than storing data on Source. This is a beta feature—see [Bring Your Own Bucket](/bring-your-own-bucket) to set up a data connection before creating the product, then select it here. From b512fea22468c955bd7d3a8c3292aaf6b5bf11fd Mon Sep 17 00:00:00 2001 From: Anthony Lukach Date: Tue, 27 Oct 2026 11:20:03 -0700 Subject: [PATCH 3/3] docs: suggested tags are sent for review when the product is saved Follows source-cooperative/source.coop#648, where a suggested tag waits in the form until the product is saved, and tags are spelled with hyphens. Co-Authored-By: Claude Opus 5.5 --- docs/using-source/create-a-data-product.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/using-source/create-a-data-product.md b/docs/using-source/create-a-data-product.md index c357127..822a9b5 100644 --- a/docs/using-source/create-a-data-product.md +++ b/docs/using-source/create-a-data-product.md @@ -16,7 +16,7 @@ Data products can be owned by an organization or an individual. You will see a d - - **Product ID**: 3–39 characters, alphanumeric and hyphens only (A–Z, 0–9, -). No consecutive hyphens, and it cannot start or end with a hyphen. The identifier appears in the URL. - **Description**: Optional; maximum 500 characters. Use it for a short overview; put detailed documentation in the README. - **Visibility**: New data products are created **Unlisted** (not shown in search). When ready to publish, open the data product page, click the gear icon, and set the state to **Listed**. -- **Tags**: Optional. Click **Add tags** (or **Edit tags**) to tick tags from Source's list, using the box at the top to filter it. Each tag you choose appears as a chip you can remove. Tags help others discover your data. If the tag you need isn't on the list, type it in the filter box and click **Suggest**. The tag is added to your data product's settings straight away, marked *pending*, but nobody else sees it until the Source team reviews it. The team approves it, swaps it for an existing tag that means the same thing, or removes it. You can have up to five suggestions awaiting review at once. +- **Tags**: Optional. Click **Add tags** (or **Edit tags**) to tick tags from Source's list, using the box at the top to filter it. Each tag you choose appears as a chip you can remove. Tags help others discover your data. If the tag you need isn't on the list, type it in the filter box and click **Suggest**. The tag shows as *new* until you save the data product; saving sends it for review, and nothing is suggested if you leave without saving. Tags are written in lowercase with hyphens between words, so *Sea Ice* becomes `sea-ice`. Until the Source team reviews it, the tag shows as *pending* in your data product's settings, and nobody else sees it. The team approves it, swaps it for an existing tag that means the same thing, or removes it. You can have up to five suggestions awaiting review at once. - **Data Connection**: Choose where the product's data lives. By default it uses Source-managed storage. If you've set up [Bring Your Own Bucket](/bring-your-own-bucket), select the data connection for your bucket instead. If you don't have a strong preference, choose a connection in the `us-west-2` region—this is where most Source data lives, and colocating keeps access fast and avoids cross-region transfer costs. You can bring an existing S3 bucket you own rather than storing data on Source. This is a beta feature—see [Bring Your Own Bucket](/bring-your-own-bucket) to set up a data connection before creating the product, then select it here.