Skip to content

Restructure samples into category-first taxonomy (apps / snippets / traditional / server-logic)#109

Merged
tyaginidhi merged 3 commits into
mainfrom
restructure/samples-apps-snippets-traditional
Jul 3, 2026
Merged

Restructure samples into category-first taxonomy (apps / snippets / traditional / server-logic)#109
tyaginidhi merged 3 commits into
mainfrom
restructure/samples-apps-snippets-traditional

Conversation

@tyaginidhi

Copy link
Copy Markdown
Contributor

What & why

Reorganizes samples/ from a framework-first layout (spa/react/, spa/angular/, spa/vue/) to a category-first taxonomy, to prepare the repo for a large influx of single-topic samples. No source code changed — the 14 existing samples were relocated via git mv (history preserved), with docs reconciled.

New structure

samples/
  spa/
    apps/       full, multi-feature apps        <name>/<framework>/  (car-sales has react + angular)
    snippets/   single-topic samples            React-only, flat (file-upload is a variant family)
  traditional/  non-code Liquid / web-template sites (enhanced data model)
    edm-liquid-webtemplate-starter/   placeholder for the first planned EDM sample
  server-logic/ server-side runtime code
    sharepoint-integration/

Changes

  • Moved all 14 existing samples into spa/apps/, spa/snippets/, traditional/, server-logic/ (3937 pure renames, byte-identical).
  • Docs reconciled: root README.md, samples/spa/README.md, and new index READMEs for traditional/ and server-logic/; all cd/link/deep-link paths fixed; the two SharePoint samples now cross-link.
  • CONTRIBUTING.md: documents the layout, an apps-vs-snippets classification rule with objective signals, the snippet-variant-family pattern, and graduation triggers (snippet -> app, and server-logic -> a future extensions/ parent).
  • MIGRATION.md: old -> new moved-paths table (GitHub does not redirect renamed paths), linked from the README intro.
  • EDM placeholder folder staked out under traditional/, clearly marked non-functional.

Validation

  • 134/134 relative links/images resolve.
  • File-count integrity: 3940 -> 3943 (only the 3 new index/placeholder READMEs added; everything else pure rename).
  • Both moved framework apps (npm install) succeed; builds are gated only by the local Node version floor (environmental, not path-related).
  • Reviewed via a three-perspective dev-team review (correctness / integrity / design); all P1/P2/P3 findings addressed in the doc commit.

Out of scope (pre-existing, not touched)

  • Malformed template-literal redaction in server-logic/sharepoint-integration/readme.md.
  • Stale .powerpages-site bundle snapshots in cloud-flow, file-upload/notes, vue-admin-template.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

tyaginidhi and others added 3 commits July 3, 2026 15:02
Reorganize the samples tree so full reference applications and single-topic
snippets are clearly separated, and non-code sites + server logic live under
a new traditional/ category:

- spa/apps/<name>/<framework>/   full multi-feature apps (car-sales react+angular,
  credit-cards react, vue-admin vue)
- spa/snippets/<topic>/          single-topic React samples (environment-variables,
  localization, authentication, fluent-ui, cloud-flow, file-upload/*)
- traditional/server-logic/      server-side logic samples (sharepoint-integration)

All moves preserve history (git rename detection). Root README.md and
samples/spa/README.md index tables regrouped into Apps/Snippets with corrected
paths; a new Traditional category is documented. Fixed stale cd/link paths and
self-referential folder names in the affected sample READMEs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…apply review follow-ups

- Move server-logic to samples/server-logic/ (peer of spa/ and traditional/)
- Add traditional/edm-liquid-webtemplate-starter/ placeholder for first EDM sample
- Fix app README deploy paths (cd into <name>/<framework>)
- Add apps-vs-snippets classification + graduation rule to CONTRIBUTING.md
- Cross-link the two SharePoint samples; add traditional/ and server-logic/ index READMEs
- Update root README to three top-level categories

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…/P2/P3)

- Add MIGRATION.md (old->new moved-paths table) + link from README (P1)
- Document snippet variant-family layout spa/snippets/<topic>/<variant>/ (P1)
- Add server-logic -> extensions/ graduation trigger to CONTRIBUTING (P2)
- Tighten apps-vs-snippets rule with objective signals + <topic>-><name> naming (P2/P3)
- Point EDM placeholder at a tracking issue for ownership (P3)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Comment thread MIGRATION.md
@tyaginidhi tyaginidhi merged commit c84079b into main Jul 3, 2026
3 checks passed
@tyaginidhi tyaginidhi deleted the restructure/samples-apps-snippets-traditional branch July 3, 2026 11:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants