Skip to content

docs: add FAQ for declaration files directory structure#1446

Merged
Timeless0911 merged 1 commit intomainfrom
docs/faq-root-dir
Jan 21, 2026
Merged

docs: add FAQ for declaration files directory structure#1446
Timeless0911 merged 1 commit intomainfrom
docs/faq-root-dir

Conversation

@Timeless0911
Copy link
Copy Markdown
Contributor

Summary

Add a new FAQ item explaining why the directory structure of declaration files might not meet expectations and how to fix it using rootDir in tsconfig.json. Both English and Chinese versions are updated.

Related Links

Checklist

  • Tests updated (or not required).
  • Documentation updated (or not required).

Copilot AI review requested due to automatic review settings January 21, 2026 04:48
@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying rslib with  Cloudflare Pages  Cloudflare Pages

Latest commit: 8dafd3c
Status: ✅  Deploy successful!
Preview URL: https://fbbf059e.rslib.pages.dev
Branch Preview URL: https://docs-faq-root-dir.rslib.pages.dev

View logs

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

This PR adds a new FAQ item to both English and Chinese documentation explaining why TypeScript declaration files may have an unexpected directory structure and how to resolve it by explicitly setting the rootDir in tsconfig.json.

Changes:

  • Added FAQ section explaining the relationship between rootDir configuration and declaration file output structure
  • Included a practical example showing the problem when composite is set to true
  • Provided a clear solution with JSON configuration example

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
website/docs/en/guide/faq/features.mdx Added English FAQ entry about declaration file directory structure
website/docs/zh/guide/faq/features.mdx Added Chinese FAQ entry about declaration file directory structure (identical content to English version)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@netlify
Copy link
Copy Markdown

netlify bot commented Jan 21, 2026

Deploy Preview for rslib ready!

Name Link
🔨 Latest commit 8dafd3c
🔍 Latest deploy log https://app.netlify.com/projects/rslib/deploys/69705a90b6fd740008996d3e
😎 Deploy Preview https://deploy-preview-1446--rslib.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@Timeless0911 Timeless0911 merged commit 50fbf9a into main Jan 21, 2026
23 checks passed
@Timeless0911 Timeless0911 deleted the docs/faq-root-dir branch January 21, 2026 04:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants