Skip to content

♻️ Generate documentation from JSDoc using typedoc #519

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Mar 4, 2024

Conversation

juliencrn
Copy link
Owner

The main purpose of this PR is to use JSDoc as the unique source of truth to generate the documentation.

Features:

  • Improved JSDoc comments
  • Refactored the root scripts improving data (hook docs) access using typedoc
  • Refactored the website using the new content
  • Created a base of the v3 migration guide

It helps

  • to have a better in-IDE doc making JSDoc-first
  • to add more information to the online documentation
  • to have some hooks' metadata to improve the README, the Algolia search index, and the docs SEO
  • Simplifying the messy and duplicated data access in both the scripts and the website

@juliencrn juliencrn added the V3 Something introduces breaking changes. label Mar 3, 2024
Copy link

changeset-bot bot commented Mar 3, 2024

🦋 Changeset detected

Latest commit: 47f174d

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages
Name Type
usehooks-ts Major
www Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@juliencrn juliencrn merged commit 200eff4 into v3 Mar 4, 2024
@juliencrn juliencrn deleted the refactor/documentation-generation branch March 4, 2024 13:51
juliencrn added a commit that referenced this pull request Mar 4, 2024
* Improve JSDoc comments and rename or make private some type aliases

* add typedoc to generate docs from jsdoc

* refactor scripts related to doc generation

* update website to read the new md files instead

* Delete removed hooks files

* Reword hook summaries to uniformize

* Create base v3 migrate page on the docs to list deleted hooks

* Create permanent redirections from deleted hooks to migration guide

* Add hook's summary to the hook list in the README

* Fix lock file
juliencrn added a commit that referenced this pull request Mar 5, 2024
* Improve JSDoc comments and rename or make private some type aliases

* add typedoc to generate docs from jsdoc

* refactor scripts related to doc generation

* update website to read the new md files instead

* Delete removed hooks files

* Reword hook summaries to uniformize

* Create base v3 migrate page on the docs to list deleted hooks

* Create permanent redirections from deleted hooks to migration guide

* Add hook's summary to the hook list in the README

* Fix lock file
juliencrn added a commit that referenced this pull request Mar 8, 2024
* 🏗️ Move the full workspace to ES Module (#502)

* 🔥 Remove deprecated hooks and co (#503)

* ♻️ Prefer type over interface (#515)

* ♻️ Generate documentation from JSDoc using typedoc (#519)

* 📝 Fix documentation build with some little improvements

* 👷 Add "DOM.Iterable" as the code runs in the DOM

* 📝 Add Algolia doc search command menu (#513)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
V3 Something introduces breaking changes.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant