Skip to content

Rename namespaces from Microsoft.Azure.Connectors to Azure.Connectors #87

@daviburg

Description

@daviburg

Summary

Drop the Microsoft. prefix from all namespaces to follow the Azure SDK Azure.<group>.<service> convention and align with the Python SDK (which already uses azure.connectors.sdk).

This is NOT about introducing any LogicApps or Workflow terms. The SDK belongs to the API Hub / Connectors team. The target namespace is Azure.Connectors.*, not Azure.LogicApps.*.

Namespace Mapping

Component Current New
Core SDK Microsoft.Azure.Connectors.Sdk Azure.Connectors.Sdk
Core SDK Auth Microsoft.Azure.Connectors.Sdk.Authentication Azure.Connectors.Sdk.Authentication
Core SDK Http Microsoft.Azure.Connectors.Sdk.Http Azure.Connectors.Sdk.Http
Core SDK Serialization Microsoft.Azure.Connectors.Sdk.Serialization Azure.Connectors.Sdk.Serialization
DirectClient root Microsoft.Azure.Connectors.DirectClient Azure.Connectors
Generated clients Microsoft.Azure.Connectors.DirectClient.<Connector> Azure.Connectors.<Connector>
NuGet package ID Microsoft.Azure.Connectors.Sdk Azure.Connectors.Sdk

Source

  • Azure SDK .NET design guidelines: Namespaces
  • APIView AI: 6 "Must fix" comments on namespace naming
  • Anu Thomas (Azure SDK team) acknowledged this may not apply but the cross-language consistency argument is strong
  • Python SDK already uses azure.connectors.sdk / azure.connectors.<connector>
  • API Design Evaluation document: Suggestion This repo is missing a license file #1

Scope of Changes

SDK repo (Connectors-NET-SDK)

  • All .cs files: update namespace declarations and using statements
  • Microsoft.Azure.Connectors.Sdk.csproj: update PackageId, assembly name
  • Directory.Build.props / Directory.Build.targets: update root namespace if set
  • Test project: update namespaces and usings
  • README, CHANGELOG, docs

BPM codegen (CodefulSdkGenerator)

  • Update namespace templates in the code generator to emit Azure.Connectors.<Connector> instead of Microsoft.Azure.Connectors.DirectClient.<Connector>

Samples repo (Connectors-NET-Samples)

  • Update all using statements

LSP repo (Connectors-NET-LSP)

  • Update any namespace references to the SDK

Python SDK (already aligned)

  • No changes needed (already azure.connectors.sdk)

Node SDK

  • Evaluate alignment separately

Breaking Change

Yes — this is an API-breaking namespace change. Per Azure SDK versioning rules, this requires either a new major version or a new package identity.

Implementation Notes

  • Create a new worktree/branch for this work
  • Mechanical find-and-replace across repos
  • Verify dotnet build and dotnet test pass after rename
  • Update NuGet package metadata
  • Consider whether adparch registration is needed for the Azure.* namespace

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions