Skip to content

Update release notes and user manual for v0.8.0#632

Merged
tnaum-ms merged 16 commits into
nextfrom
dev/tnaum/prepare-0.8.0-release
May 12, 2026
Merged

Update release notes and user manual for v0.8.0#632
tnaum-ms merged 16 commits into
nextfrom
dev/tnaum/prepare-0.8.0-release

Conversation

@tnaum-ms
Copy link
Copy Markdown
Collaborator

This pull request documents the v0.8.0 release of the DocumentDB for VS Code extension, marking a major upgrade that transforms the extension into a comprehensive query development environment. The update introduces context-aware autocompletion, a new Query Playground, an integrated Interactive Shell, and seamless navigation between query surfaces. It also brings improvements to query insights, usability, and dependency updates. The most important changes are summarized below.

Major New Features:

  • Context-aware autocompletion in the Collection View: Editors now provide schema-aware suggestions, type-aware operator ordering, hover documentation, relaxed query syntax, and real-time validation. [1] [2]
  • Query Playground: New .documentdb.js files allow users to write and execute JavaScript scripts with CodeLens execution, console output, per-file connections, and autocompletion for db.* chains. No external tools required. [1] [2]
  • Interactive Shell: Adds a REPL terminal with shell commands, persistent context, syntax highlighting, tab completion, cancellation, and clickable navigation links. [1] [2]
  • Cross-feature navigation: Enables seamless movement of queries between Collection View, Query Playground, and Interactive Shell via toolbar buttons, CodeLens actions, and clipboard support. [1] [2]

Improvements and Fixes:

  • Query Insights: Enhanced static analysis with new metrics, badge system, and alignment between AI and static analysis. [1] [2]
  • Usability: Double-click required to open Collection View, custom editor tab icons, About dialog, standardized telemetry, and prerelease version migration. [1] [2]
  • Duplicate connection reveal: Fixed an issue where revealing a duplicate connection inside a folder failed. [1] [2]

Documentation Updates:

  • Added detailed release notes for v0.8.0 in docs/release-notes/0.8.md, including feature descriptions, screenshots, and usage guidance.
  • Updated the user manual index to include new sections for querying features: Collection View, Query Playground, Interactive Shell, and runtime internals.

Dependency Updates:

  • Upgraded fast-uri, fast-xml-builder, basic-ftp, path-to-regexp, and related dependencies to their latest versions. [1] [2]

Copilot AI review requested due to automatic review settings May 12, 2026 09:56
@tnaum-ms tnaum-ms requested a review from a team as a code owner May 12, 2026 09:56
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds documentation for the v0.8.0 release of the DocumentDB for VS Code extension, expanding the user manual with new “Querying” feature guides and publishing the v0.8 release notes/changelog entry.

Changes:

  • Added new user manual pages for Collection View querying, Query Playground, Interactive Shell, and runtime internals.
  • Added v0.8 release notes and linked them from the docs index.
  • Added a new 0.8.0 section to CHANGELOG.md.

Reviewed changes

Copilot reviewed 7 out of 15 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
docs/user-manual/query-runtime.md New “behind the scenes” explanation of the bundled runtime and supporting @documentdb-js/* packages.
docs/user-manual/query-playground.md New end-user guide for .documentdb.js playground authoring, execution, and navigation.
docs/user-manual/interactive-shell.md New end-user guide for the embedded REPL shell, commands, and settings.
docs/user-manual/collection-view-querying.md New guide covering Collection View query editors and autocompletion behavior.
docs/release-notes/0.8.md New v0.8 release notes with screenshots and feature highlights.
docs/index.md Adds “Querying” section to the manual index and links release notes 0.8.
CHANGELOG.md Adds a 0.8.0 changelog entry summarizing features, improvements, fixes, and dependency updates.

Comment thread docs/user-manual/collection-view-querying.md
Comment thread docs/user-manual/collection-view-querying.md Outdated
Comment thread docs/user-manual/interactive-shell.md
Comment thread docs/user-manual/query-playground.md
Comment thread docs/user-manual/query-runtime.md Outdated
Comment thread docs/release-notes/0.8.md Outdated
tnaum-ms added 2 commits May 12, 2026 13:15
- Fix Context-Sensitive Completions table in collection-view-querying.md:
  escape pipe characters used as cursor position indicators (| → \|)
  so they render as literals instead of column separators in GFM tables.
  Also fix separator row from 3 columns to 2 columns.
- Remove leftover <--- stale setting references IMAGE PROMPT: ... --> authoring comment from
  0.8 release notes (no longer needed after screenshot was generated).
@tnaum-ms tnaum-ms requested a review from Copilot May 12, 2026 13:35
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 29 changed files in this pull request and generated 1 comment.

Comment thread docs/user-manual/query-runtime.md Outdated
@github-actions
Copy link
Copy Markdown
Contributor

✅ Code Quality Checks

Check Status How to fix
Localization (l10n) ✅ Passed
ESLint ✅ Passed
Prettier formatting ✅ Passed

This comment is updated automatically on each push.

@github-actions
Copy link
Copy Markdown
Contributor

📦 Build Size Report

Metric Base (next) PR Delta
VSIX (vscode-documentdb-0.8.0.vsix) 6.79 MB 7.51 MB ⬆️ +737 KB (+10.6%)
Webview bundle (views.js) 5.79 MB 5.79 MB ✅ 0 KB (0.0%)

Download artifact · updated automatically on each push.

@tnaum-ms tnaum-ms merged commit df5bbb5 into next May 12, 2026
8 checks passed
@tnaum-ms tnaum-ms deleted the dev/tnaum/prepare-0.8.0-release branch May 12, 2026 15:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

4 participants