Skip to content

Align FSLogix topology terminology between AVD and SOFS repos #36

@kristopherjturner

Description

@kristopherjturner

Problem

The AVD and SOFS repos use different terminology for the same FSLogix share topologies, causing confusion for users following deployment guides across both repos.

Concept AVD Repo (variables.example.yml) SOFS Repo (docs/architecture)
Single share for all FSLogix data single Option A
Three separate shares (Profiles/ODFC/AppData) split Option B
Cloud Cache replication cloud_cache Cloud Cache (DR overlay)

Neither repo defines a mapping between these terms. A user reading both repos has to mentally figure out that split = Option B.

Discussion Points

  • Which terminology should be canonical? single/split/cloud_cache or Option A/Option B?
  • Should we define both with a mapping table in each repo?
  • Should the config variables.example.yml use the same enum values?
  • AVD can focus on more than just profiles on SOFS — should the topology terminology be extended for general-purpose SOFS use cases?

Acceptance Criteria

  • Agree on canonical terminology for share topologies
  • Update AVD repo variables.example.yml FSLogix topology enum values
  • Update SOFS repo documentation to use aligned terminology
  • Add cross-reference mapping table in both repos' FSLogix docs
  • Ensure config schema validation uses the same enum values

Affected Repos

  • azurelocal-avdconfig/variables.example.yml, docs/guides/fslogix.md
  • azurelocal-sofs-fslogixdocs/architecture/overview.md, docs/getting-started.md, config/variables.example.yml

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions