Skip to content

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 force-pushed the update-typedocs-0.25.13 branch from 449773b to fda47d3 Compare May 15, 2024 11:16
@teogeb teogeb changed the base branch from main to fix-setProxies-import-in-FakeNetworkNode May 15, 2024 11:17
@teogeb teogeb force-pushed the update-typedocs-0.25.13 branch from fda47d3 to ad89a63 Compare May 15, 2024 11:31
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
@linear
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
@teogeb
Copy link
Contributor Author

teogeb commented Nov 28, 2024

Replaced by PR #2917

@teogeb teogeb closed this Nov 28, 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.

2 participants