4 Commits

  • Improve CONTRIBUTING.md with dev setup links and docs guidance (#5000)
    * Improve CONTRIBUTING.md with dev setup links and docs guidance
    
    - Consolidate Development Scripts into a Development Setup section with
      quick links to language-specific dev guides and coding standards
    - Add Python build/test/lint commands alongside existing .NET commands
    - Add Documentation Contributions section with link checker, writing
      guidelines, and style guidance
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    * Use directory note for .NET commands, matching Python style
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    * Split test commands into unit vs. integration for both Python and .NET
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    * Remove Documentation Contributions section
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    ---------
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  • .NET: Add API breaking change validation for RC packages (#4977)
    * Add API breaking change validation for RC packages
    
    Enable .NET Package Validation for release candidate packages to detect
    API breaking changes in CI. This follows the same pattern used by
    Semantic Kernel, centralized through nuget-package.props.
    
    Changes:
    - Enable EnablePackageValidation for IsReleaseCandidate packages
    - Update PackageValidationBaselineVersion to 1.0.0-rc4 (latest published)
    - Generate CompatibilitySuppressions.xml for existing known API changes
      in 5 packages (AI, AzureAI, OpenAI, Workflows, Workflows.Declarative.AzureAI)
    - Opt out Workflows.Declarative.Mcp (not yet published to NuGet)
    - Add breaking changes guidance to CONTRIBUTING.md
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    * Address PR review feedback
    
    - Remove unnecessary empty PackageValidationBaselineVersion override
      in Workflows.Declarative.Mcp.csproj (EnablePackageValidation=false
      is sufficient)
    - Tighten CONTRIBUTING.md wording to clarify opt-out possibility
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    * Enable package validation for GA packages (no VersionSuffix)
    
    Expand the EnablePackageValidation condition to also cover future GA
    packages that have no VersionSuffix, not just RC packages.
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    * Fix EnablePackageValidation GA condition to check PackageVersion
    
    The previous condition VersionSuffix=='' matched all packages (preview
    included) since VersionSuffix defaults to empty. Now uses two separate
    conditions: one for RC, one for true GA (PackageVersion == VersionPrefix).
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    * Add IsGeneralAvailable flag for package validation
    
    Replace fragile PackageVersion condition with explicit IsGeneralAvailable
    property, following the same per-project self-declaration pattern as
    IsReleaseCandidate.
    
    - Directory.Build.props: Add IsGeneralAvailable=false default
    - nuget-package.props: EnablePackageValidation on RC OR GA
    - CONTRIBUTING.md: Update docs to mention both flags
    
    When packages go GA, they set IsGeneralAvailable=true in their .csproj.
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    * Rename IsGeneralAvailable to IsGenerallyAvailable
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
    
    ---------
    
    Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  • Python: updated docstrings of all _files (#1107)
    * updated docstrings of all _files
    
    * fix mypy
    
    * fixed codeblocks in workflows and some other files
    
    ---------
    
    Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>
  • Added contributing guidelines (#470)
    * Added contributing guidelines
    
    * Address PR feedback: remove TypeScript references and fix .NET build commands