Skip to content

docs: add release note for TypeSpec v1.10.0 and release notes creation guide#9979

Open
Copilot wants to merge 5 commits intomainfrom
copilot/create-release-note
Open

docs: add release note for TypeSpec v1.10.0 and release notes creation guide#9979
Copilot wants to merge 5 commits intomainfrom
copilot/create-release-note

Conversation

Copy link
Contributor

Copilot AI commented Mar 10, 2026

Creates the release note for the upcoming v1.10.0 release, compiled from .chronus/changes/ changesets filtered to typespec-stable and typespec-preview policy packages. Dependencies category removed per convention.

Also adds a concise "Creating release notes" section to CONTRIBUTING.md describing how to run pnpm chronus changelog --policy typespec-stable --policy typespec-preview, where to create the output file, and that the Dependencies category should be removed.

Included changes

Features

  • @typespec/compiler: Functions language feature, internal type modifier, tsp info <libName>, exported resolveCodeFix
  • @typespec/openapi + @typespec/openapi3: OpenAPI 3.2 nested tags via parent in @tagMetadata
  • @typespec/openapi3: file-type accepts array, import readOnly/writeOnly as visibility decorators

Bug Fixes

  • @typespec/compiler: @overload in versioned namespaces, string template interpolation, custom npm registry, serializeValueAsJson ICE, templated alias member instantiation
  • @typespec/http: Route join behavior for ?/: prefixes, removed patch-implicit-optional warning
  • @typespec/openapi: setOperationId API exposure
  • @typespec/openapi3: JSON Schema sibling keywords alongside $ref, nullable array constraints
  • @typespec/versioning: Multiple versioning mutators running together
  • @typespec/html-program-viewer: Symbol-keyed decorator state display
Original prompt

This section details on the original issue you should resolve

<issue_title>Create release note for next release</issue_title>
<issue_description>Use pattern of existing release notes in website

run pnpm chronus changelog --policy typespec-stable --policy typespec-preview a to get the output and and cleanup(remve dependency category)</issue_description>

Comments on the Issue (you are @copilot in this section)


🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

Co-authored-by: timotheeguerin <1031227+timotheeguerin@users.noreply.github.com>
@microsoft-github-policy-service microsoft-github-policy-service bot added the meta:website TypeSpec.io updates label Mar 10, 2026
Copilot AI changed the title [WIP] Add release note for next version docs: add release note for TypeSpec v1.10.0 Mar 10, 2026
@timotheeguerin
Copy link
Member

@copilot looks good, can you add a new section to the contributing guide(or a skill if that is better) on how to make those release notes from your findings in this session

Co-authored-by: timotheeguerin <1031227+timotheeguerin@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Mar 10, 2026

@copilot looks good, can you add a new section to the contributing guide(or a skill if that is better) on how to make those release notes from your findings in this session

Added both a contributing guide section and a skill (commit 53fe1b2):

  1. CONTRIBUTING.md — Added a "Creating release notes" section under "TypeSpec website" with both automated (pnpm chronus changelog --policy typespec-stable --policy typespec-preview) and manual approaches, plus a template.

  2. .github/skills/create-release-notes/SKILL.md — A detailed skill file covering: how to determine the next version, which packages are in each policy, how to filter changesets, how to find PR numbers from git log, and how to format the release note file.

  3. .github/copilot-instructions.md — Registered the new skill under "Available Task Instructions".

Copilot AI changed the title docs: add release note for TypeSpec v1.10.0 docs: add release note for TypeSpec v1.10.0 and release notes creation guide Mar 10, 2026
Co-authored-by: timotheeguerin <1031227+timotheeguerin@users.noreply.github.com>
@azure-sdk
Copy link
Collaborator

You can try these changes here

🛝 Playground 🌐 Website 🛝 VSCode Extension

github-merge-queue bot pushed a commit to Azure/typespec-azure that referenced this pull request Mar 10, 2026
…4026)

Creates release notes for the TypeSpec Azure 0.66.0 release and adds a
dedicated "Creating release notes" section to the contributing guide.

## Changes Made

### Release Notes
(`website/src/content/docs/docs/release-notes/release-2026-03-10.mdx`)

Created release notes for version 0.66.0, including:

- **Features** — `@azure-tools/typespec-client-generator-core`: Added
`.streamMetadata` for SSE events streamed in or out
- **Bug Fixes** — `@azure-tools/typespec-client-generator-core`: Fixed
namespace duplication when `@clientNamespace` extends the namespace flag

The `Dependencies` category was excluded as it is not user-facing.

### Contributing Guide (`CONTRIBUTING.md`)

Added a dedicated "Creating release notes" section (similar to
[microsoft/typespec#9979](microsoft/typespec#9979))
that explains:

- The command to generate the changelog: `pnpm chronus changelog
--policy typespec-azure`
- Where to create the output file
(`website/src/content/docs/docs/release-notes/release-YYYY-MM-DD.mdx`)
- The required frontmatter template including the TypeSpec Core link
card
- Why the `Dependencies` category should be removed (dependency updates
are not user-facing)

<!-- START COPILOT ORIGINAL PROMPT -->



<details>

<summary>Original prompt</summary>

> 
> ----
> 
> *This section details on the original issue you should resolve*
> 
> <issue_title>Create release notes for current release</issue_title>
> <issue_description>Use `chronus version --policy typespec-azure` and
remove the dependency category</issue_description>
> 
> ## Comments on the Issue (you are @copilot in this section)
> 
> <comments>
> </comments>
> 


</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

- Fixes #4025

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for
you](https://github.com/Azure/typespec-azure/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot)
— coding agent works faster and does higher quality work when set up for
your repo.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: timotheeguerin <1031227+timotheeguerin@users.noreply.github.com>
@github-actions
Copy link
Contributor

No changes needing a change description found.

@timotheeguerin timotheeguerin added this pull request to the merge queue Mar 10, 2026
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Mar 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

eng meta:website TypeSpec.io updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create release note for next release

4 participants