From d06dae4f9a362fd401fd662849bfdad654e07fdc Mon Sep 17 00:00:00 2001 From: Josh Smith <6895577+joshsmithxrm@users.noreply.github.com> Date: Sun, 19 Apr 2026 07:19:14 -0500 Subject: [PATCH] chore(branding): remove PPDS.Tools / PPDS ALM, rename SDK to libraries Brings .claude/rules/branding.md in sync with what actually ships at v1. The freshly-pruned CLAUDE.md (#18) points to this file as the canonical name list, so stale content here actively misleads any AI session authoring docs. Changes: - Remove PPDS.Tools and PPDS ALM from the Components table (not shipping at v1, can be re-added when they do) - Remove ppds-tools and ppds-alm from the Repositories table - Remove the PSGallery link (no PPDS.Tools package) - Main repo description: SDK -> Libraries - Value prop: "standard SDK patterns" -> "standard Dataverse SDK patterns" (disambiguates Microsoft's SDK from PPDS libraries) - New Terminology section explicitly calling out libraries-vs-SDK and the NoSdkInPresentationAnalyzer rule that enforces the same convention in code Co-Authored-By: Claude Opus 4.7 (1M context) --- .claude/rules/branding.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/.claude/rules/branding.md b/.claude/rules/branding.md index b7d4c8a..aa893db 100644 --- a/.claude/rules/branding.md +++ b/.claude/rules/branding.md @@ -19,8 +19,6 @@ Use the full name on first reference in a document, then PPDS thereafter. | CLI | PPDS CLI | Interactive TUI and command-line tool | | Extension | PPDS Extension | VS Code extension | | Libraries | PPDS.* | NuGet packages (e.g., Plugins, Migration, Dataverse, Auth) | -| PowerShell | PPDS.Tools | PowerShell module | -| ALM | PPDS ALM | GitHub Actions and Azure DevOps templates | | MCP | PPDS.Mcp | MCP server for AI assistant integration (Claude Code) | ## NuGet Packages @@ -36,19 +34,20 @@ Use the full name on first reference in a document, then PPDS thereafter. | Repo | GitHub Name | Display Name | |------|-------------|--------------| -| Main | power-platform-developer-suite | PPDS (SDK + CLI + TUI + Extension + MCP) | +| Main | power-platform-developer-suite | PPDS (Libraries + CLI + TUI + Extension + MCP) | | Docs | ppds-docs | PPDS Docs | -| ALM | ppds-alm | PPDS ALM | -| Tools | ppds-tools | PPDS.Tools | | Demo | ppds-demo | PPDS Demo | | Orchestration | ppds-orchestration | PPDS Orchestration | +## Terminology + +- Use **"libraries"** (not "SDK") to refer to PPDS NuGet packages (`PPDS.Auth`, `PPDS.Dataverse`, `PPDS.Migration`, `PPDS.Plugins`). "SDK" is reserved for Microsoft's Dataverse SDK (`ServiceClient`, `IOrganizationService`) that the PPDS libraries sit on top of. Disambiguation matters — sentences like "the SDK handles throttling" are ambiguous in this codebase. The `NoSdkInPresentationAnalyzer` rule in the ppds monorepo enforces the same convention in code. + ## Links - Docs site: https://joshsmithxrm.github.io/ppds-docs/ - Main repo: https://github.com/joshsmithxrm/power-platform-developer-suite - NuGet: https://www.nuget.org/packages?q=ppds -- PSGallery: https://www.powershellgallery.com/packages/PPDS.Tools ## Visual Identity @@ -78,7 +77,7 @@ Use the full name on first reference in a document, then PPDS thereafter. **Value Props:** 1. **Unified tooling** - CLI, TUI, VS Code Extension, and MCP in one suite -2. **Performance** - 10x throughput over standard SDK patterns +2. **Performance** - 10x throughput over standard Dataverse SDK patterns 3. **AI-native** - MCP integration for Claude Code and other AI assistants 4. **Complements Microsoft's tools** - Works alongside PAC CLI, not against it