Sync default Data Use taxonomy with the restructured explorer taxonomy - #205
Draft
jwrosewell wants to merge 1 commit into
Draft
Sync default Data Use taxonomy with the restructured explorer taxonomy#205jwrosewell wants to merge 1 commit into
jwrosewell wants to merge 1 commit into
Conversation
The docs Data Use taxonomy (mkdocs/docs/csv/data_uses.csv) was restructured to the new top levels (necessary, functional, analytics, advertising_marketing, disclosure) in IABTechLab#196, but the code source of truth and generated artifacts were left on the old Fides 3.0 structure. This brings them into line: - Regenerate src/fideslang/default_taxonomy/data_uses.py from the docs CSV (now 62 data uses across the five new top levels). - Regenerate data_files/data_uses.{yml,json,csv} via scripts/export_default_taxonomy.py. - Remap src/fideslang/gvl/gvl_data_use_mapping.json from the old data-use keys to the new ones. - Update tests for the new keys and count. Open questions for maintainers are called out in the pull request description (top-level naming, source-CSV data-quality fixes, TCF/MSPA modelling, and two TCF purposes with no equivalent in the restructured taxonomy). Signed-off-by: James Rosewell <james@51degrees.com>
jwrosewell
force-pushed
the
sync-code-taxonomy-to-restructured-data-uses
branch
from
August 4, 2026 12:57
bcd323b to
3327b5d
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The Data Use taxonomy is currently in a split state. PR #196 restructured the docs taxonomy in
mkdocs/docs/csv/data_uses.csvto the new top levels (necessary,functional,analytics,advertising_marketing,disclosure) and addedtcf/mspacolumns, but the code source of truth and the artifacts generated from it were left on the old Fides 3.0 structure:src/fideslang/default_taxonomy/data_uses.pydata_files/data_uses.{yml,json,csv}src/fideslang/gvl/gvl_data_use_mapping.jsonSo a consumer reading the published package still gets
marketing.advertising.first_party.targeted,essential.*,third_party_sharing, and so on, rather than the restructured Data Uses the explorer shows. This PR brings the code in line with the docs.What changed
default_taxonomy/data_uses.pyregenerated directly frommkdocs/docs/csv/data_uses.csvso the code matches the docs, now 62 Data Uses across the five new top levels.data_files/data_uses.{yml,json,csv}regenerated viascripts/export_default_taxonomy.py.gvl/gvl_data_use_mapping.jsonremapped from the old keys to the new ones (for examplemarketing.advertising.*->advertising_marketing.*,essential.*->necessary.*,analytics.reporting.*->analytics.ad_reporting.*).Open questions for maintainers
operational, but the CSV models this asnecessary.operations(nested) plus a separatefunctionaltop level. This PR follows the CSV. Please confirm the intended top levels.advertising_marketing.personalize.content, purpose 10 ->necessary.operations.improve.necessary,analytics.ad_reporting,analytics.reporting,advertising_marketing.personalize); short descriptions were added.measure_ad_performanceandad_delivery_and_targeting); the latter was given a distinct one.tcf/mspalive? They exist only as hand-maintained columns in the docs CSV today.scripts/export_default_taxonomy.pycopiesdata_files/data_uses.csvover the docs CSV, which would drop those columns, so this PR intentionally does not overwrite the docs CSV. That leaves the docs CSV and the generateddata_filesCSV slightly out of step. Modellingtcf/mspaonDataUseso the docs CSV can be generated would be a cleaner long-term fix, but is out of scope here.Context
This came out of adopting the Data Use taxonomy as the permission vocabulary for a Trusted Server permission model (IABTechLab/trusted-server#838). The immediate need was a single, consistent, machine-readable taxonomy to build against, which surfaced the split between the code and the docs.