Skip to content

Add documentation test#1850

Open
jliusan wants to merge 2 commits intomainfrom
add-documentation-test
Open

Add documentation test#1850
jliusan wants to merge 2 commits intomainfrom
add-documentation-test

Conversation

@jliusan
Copy link
Member

@jliusan jliusan commented Jan 30, 2026

Add documentation test

Copilot AI review requested due to automatic review settings January 30, 2026 08:41
Copy link
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

This PR adds a new test case for documentation generation and formatting features in the TypeSpec Go code generator. The test validates proper handling of documentation comments with various formatting styles including bullet points, numbered lists, bold text, italic text, and combined formatting.

Changes:

  • Added new documentationgroup test package with generated Go client code
  • Registered the new test in the compilation script
  • Added test cases for text formatting (bold, italic, combined) and list formatting (bullet points, numbered lists)

Reviewed changes

Copilot reviewed 19 out of 20 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
packages/typespec-go/.scripts/tspcompile.js Registered new 'documentationgroup' test in the compilation configuration
packages/typespec-go/test/http-specs/documentationgroup/go.mod Go module definition with dependencies
packages/typespec-go/test/http-specs/documentationgroup/go.sum Dependency checksums
packages/typespec-go/test/http-specs/documentationgroup/LICENSE.txt Standard MIT license file
packages/typespec-go/test/http-specs/documentationgroup/zz_*.go Generated client, model, constant, and supporting code files
packages/typespec-go/test/http-specs/documentationgroup/fake/zz_*.go Generated fake server implementation for testing
packages/typespec-go/test/http-specs/documentationgroup/*_test.go Test files for documentation lists and text formatting clients
packages/typespec-go/test/http-specs/documentationgroup/testdata/_metadata.json Metadata file for the generated code

// BulletPointsEnum - This tests really long bullet points in enum documentation to see how wrapping and formatting are handled.
// This should wrap around correctly and maintain proper indentation for each line.
// - Simple bullet point. This bullet point is going to be very long to test how text wrapping is handled in bullet points
// within documentation comments. It should properly indent the wrapped lines.
Copy link
Member

Choose a reason for hiding this comment

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

Hmm this looks wrong. Should be indented.

Copy link
Member

@jhendrixMSFT jhendrixMSFT left a comment

Choose a reason for hiding this comment

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

Looks like there are various formatting issues. We should fix them before committing this test.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants