Skip to content

QUA-1518: Refactor Source Datastore Section#1067

Open
RafaelOsiro wants to merge 2 commits intomainfrom
qua-1518-refactor-source-datastores-section
Open

QUA-1518: Refactor Source Datastore Section#1067
RafaelOsiro wants to merge 2 commits intomainfrom
qua-1518-refactor-source-datastores-section

Conversation

@RafaelOsiro
Copy link
Contributor

@RafaelOsiro RafaelOsiro commented Mar 11, 2026

Overview

This PR adds comprehensive Datastore Grouping documentation, updates permission tables across security pages to include Field Status and Grouping features, reorganizes source datastore image assets, and fixes broken internal links.

Key Changes

  • Datastore Grouping documentation: Added 10 new pages covering overview, API reference, FAQ, deep dive (introduction, permissions), and managing groups (create, edit, delete, assign, unassign)
  • Navigation restructuring: Organized grouping pages under Navigation & Organization with sidebar order: Overview → API → FAQ → Deep Dive → Managing
  • Permission tables updated: Added Field Status operations (mask, unmask, exclude, restore, delete, merge) and Datastore Grouping actions to Team Permissions matrix, per-role tables, and Security Overview role tables
  • Field Status FAQ reorganized: Restructured flat FAQ into categorized sections (General, Masking, Excluding, Missing Fields, Deleting and Merging, Permissions, Bulk Operations)
  • Asset reorganization: Moved 172 source datastore images into topic-based subdirectories and removed -light suffix from 178 image filenames, updating all references across affected docs
  • Broken links fixed: Added missing .md extensions to internal links across 6 files, fixed logo 404 by correcting path from non-existent Logo.png to logo-light.svg, and fixed deployment diagram link pointing to .jpg instead of .svg
  • URL redirects: Added redirect mappings in mkdocs.yml to preserve existing external URLs for moved pages

Screenshots

Restructure the documentation to group related content under Source
Datastores and introduce Operations subsections for both Source
Datastores and Containers, preparing the navigation for future
feature documentation (e.g., Promote).

Source Datastores reorganization:
- Move Add Datastores (25 JDBC/DFS datastore docs + Connections)
  into Source Datastores as top-level items
- Group Catalog, Profile, Scan, External Scan under Operations
- Group settings pages under Datastore Settings
- Group Right Click Options, Assign Tags under Navigation & Organization

Container reorganization:
- Rename Enrichment Operation to Operations (Export, Materialize)

Asset restructuring:
- Move all related assets into docs/assets/source-datastores/ with
  matching subdirectory structure (add-datastores, operations,
  datastore-settings, navigation-and-organization)
- Move container operation assets into docs/assets/container/operations/
- Remove -light suffix from 950+ asset filenames (dark mode only)

Maintenance:
- Update 500+ image paths across all affected documentation files
- Fix internal cross-references in ~20 external docs
- Add 44 URL redirects to preserve all existing external links
@RafaelOsiro RafaelOsiro self-assigned this Mar 11, 2026
@RafaelOsiro RafaelOsiro added the documentation Improvements or additions to documentation label Mar 11, 2026
@RafaelOsiro RafaelOsiro marked this pull request as ready for review March 11, 2026 22:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant