Skip to content
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

deps(docs): [DREL-247] Update typedoc and typescript #2552

Draft
wants to merge 15 commits into
base: main
Choose a base branch
from

Conversation

teogeb
Copy link
Contributor

@teogeb teogeb commented May 15, 2024

Updated TypeDoc, TypeScript and two related plugins.

With these changes Docusaurus seems to generate API documentation, but the output is not optimal. We should tweak it to look more like the output of the previous version (see the output generated in main branch, or in https://docs.streamr.network/usage/sdk/api/)

Changes / TODO

  • The out directory definition has been updated. Maybe the docs/ prefix is needed now for some reason?
  • Added some exclude definitions (maybe not optimal set of files, should maybe tweak the list)
  • Added "readme: none" definition as we don't seem to need that (see refine-docs/index.js#110)
  • Removed obsolete refine-api-reference.ts file (the functionality was moved to refine-docs/index.js in Docs fix #1361)
  • Removed sidebar config as it doesn't seem to work (doesn't remove version number from the title). Note that there is also sidebars.js config file, maybe it conflicts with that? (not clear if either of these configs is obsolete).
  • The refine-docs plugin is temporarily disabled. We should update some parts of the implementation (refine-docs/index.js) so that it is compatible with the current version.

@teogeb teogeb changed the base branch from main to fix-setProxies-import-in-FakeNetworkNode May 15, 2024 11:17
Base automatically changed from fix-setProxies-import-in-FakeNetworkNode to main May 15, 2024 11:52
@teogeb teogeb changed the title deps(docs): update typedoc and typescript deps(docs): [DREL-247] Update typedoc and typescript Nov 13, 2024
Copy link

linear bot commented Nov 13, 2024

@github-actions github-actions bot added the sdk label Nov 14, 2024
@teogeb teogeb marked this pull request as draft November 14, 2024 13:22
teogeb added a commit that referenced this pull request Nov 15, 2024
Using `@remarks` tag instead of `@remark`. Was most likely a typo.
TypeDoc supports only the tag as plural
(https://typedoc.org/tags/remarks/).

The unknown tag would trigger a warning when we update to latest TypeDoc
(#2552).
@github-actions github-actions bot removed the sdk label Nov 15, 2024
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.

1 participant