grafana/docs/sources/as-code/observability-as-code/git-sync
Roberto Jiménez Sánchez afb7384f51
Docs: Document the folderless Git Sync target (#125810)
* Docs: Document the folderless Git Sync target

Adds a "Sync targets" section to the Git Sync key concepts page
describing the `folder` and `folderless` targets, and updates the
code-based setup page to document `target: folderless` alongside
`target: folder`.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* Docs: Add folder vs folderless examples to Git Sync key concepts

Focus the Sync targets section on the folder and folderless modes and
add worked examples showing how the same repository files map to the
Dashboards view under each target.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* Docs: Refine folderless sync target examples in key concepts

Describe the folder and folderless sync modes conceptually instead of by
the spec.sync.target field (the field stays documented in the setup
page), show unprovisioned content alongside synced resources in the
examples, and add a multiple-folderless example.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* Update docs/sources/as-code/observability-as-code/git-sync/key-concepts.md

Co-authored-by: Anna Urbiztondo <anna.urbiztondo@grafana.com>

* Update docs/sources/as-code/observability-as-code/git-sync/key-concepts.md

Co-authored-by: Anna Urbiztondo <anna.urbiztondo@grafana.com>

* Docs: Move sync target when-to-use guidance to top of section

Address review feedback: surface when to use folder vs folderless sync
up front, before the worked examples, since that's what readers want
to know first. Remove the now-redundant trailing paragraph.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Anna Urbiztondo <anna.urbiztondo@grafana.com>
2026-06-09 16:53:38 +02:00
..
git-sync-setup Docs: Document the folderless Git Sync target (#125810) 2026-06-09 16:53:38 +02:00
scenarios Docs: Git Sync permissions (#123011) 2026-04-23 12:52:18 +02:00
_index.md Docs: Git Sync permissions (#123011) 2026-04-23 12:52:18 +02:00
export-resources.md Docs: Git Sync - dashboard updates (#125944) 2026-06-08 12:02:24 +02:00
key-concepts.md Docs: Document the folderless Git Sync target (#125810) 2026-06-09 16:53:38 +02:00
permissions-git.md Docs: Git Sync permissions (#123011) 2026-04-23 12:52:18 +02:00
permissions-grafana.md Docs: Git Sync link fix (#124782) 2026-05-13 12:28:35 +02:00
provisioned-dashboards.md Docs: Git Sync permissions (#123011) 2026-04-23 12:52:18 +02:00
usage-limits.md Docs: Git Sync - Resource limits (#125536) 2026-06-08 11:52:18 +02:00
use-git-sync.md Docs: Git Sync link fix (#124782) 2026-05-13 12:28:35 +02:00