Skip to content

Conversation

Zyie
Copy link
Member

@Zyie Zyie commented May 16, 2025

This PR overhauls our documentation to use TypeDoc and removes the documentation quirks from using webdoc

This also introduces the idea that anything that has been exported should explicitly state whether or not it is meant for internal or public use. This is done by using the @internal tag. This should help us clearly define our public API and give us more freedom to change the internals of pixi

To help ensure our docs remain consistent there is also a custom eslint plugin that forces a tag to be applied to anything that has been exported

https://pixijs.download/feat/typedoc/docs/index.html

Follow up tasks:

  • apply styling to match current docs
  • add redirects to help with migrating over to new docs structure
  • add back google analytics tracking
  • implement @experimental tags
  • implement @standard / @advanced tags

Copy link

codesandbox-ci bot commented May 16, 2025

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit af301c7:

Sandbox Source
pixi.js-sandbox Configuration

Copy link
Member

@GoodBoyDigital GoodBoyDigital left a comment

Choose a reason for hiding this comment

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

this is great work Sean!

@Zyie Zyie added this pull request to the merge queue May 19, 2025
@Zyie Zyie added the ✅ Ready To Merge Helpful when issues are in the queue waiting to get merged. This means the PR is completed and has t label May 19, 2025
Merged via the queue into dev with commit 34926f0 May 19, 2025
5 checks passed
@Zyie Zyie deleted the feat/typedoc branch May 19, 2025 08:47
@bigtimebuddy
Copy link
Member

Awesome job @Zyie! I'm glad we got the big lift here out of the way in this PR. Do you want to capture a project board with those remaining tasks?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
✅ Ready To Merge Helpful when issues are in the queue waiting to get merged. This means the PR is completed and has t
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants