Skip to content

chore(branding): remove PPDS.Tools / PPDS ALM, rename SDK to libraries #19

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
joshsmithxrm merged 1 commit into from
Apr 19, 2026
Merged

chore(branding): remove PPDS.Tools / PPDS ALM, rename SDK to libraries #19

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 6 additions & 7 deletions .claude/rules/branding.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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) |

@gemini-code-assist gemini-code-assist Bot Apr 19, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The list of components in the repository description should follow the order established in the 'Components' table (lines 19-22) for better consistency. Additionally, 'TUI' should be grouped as a feature of the 'CLI' component. Please ensure these rules are centralized in the primary AI instructions file to avoid duplication and maintain a single source of truth.

Suggested change
| Main | power-platform-developer-suite | PPDS (Libraries + CLI + TUI + Extension + MCP) |
| Main | power-platform-developer-suite | PPDS (CLI + TUI + Extension + Libraries + MCP) |
References
  1. Centralize global rules in a primary file to maintain a single source of truth and conserve context.

| 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.

@gemini-code-assist gemini-code-assist Bot Apr 19, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Capitalize the product abbreviation as 'PPDS' for consistency with branding guidelines. Additionally, use 'libraries' for PPDS packages and 'SDK' for the underlying Microsoft Dataverse SDK to avoid ambiguity. These rules should be centralized in the primary AI instructions file to avoid duplication.

Suggested change
- 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.
- 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.
References
  1. Centralize global rules in a primary file to maintain a single source of truth and conserve context.


## 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

Expand Down Expand Up @@ -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

Expand Down
Loading