docusaurus-plugin-typedoc-api icon indicating copy to clipboard operation
docusaurus-plugin-typedoc-api copied to clipboard

Next version of the docs is not rendered with v3.0.1

Open B4nan opened this issue 2 years ago • 3 comments

Another issue we encountered that holds us from updating, with versioning, the next version (so the snapshot of the current master branch) is not rendered at all and results in 404.

Visible in this renovate PR which updates only the typedoc plugin:

https://github.com/apify/apify-client-js/pull/423

It fails as the /api/client/js/reference/next page is missing, this works fine with the previous version (https://docs.apify.com/api/client/js/reference/next).

B4nan avatar Oct 12 '23 10:10 B4nan

Looking at the docusaurus route debugger, I can see the route is actually registered but has no child routes.

image

Here is our plugin setup:

    plugins: [
        [
            'docusaurus-plugin-typedoc-api',
            {
                projectRoot: `${__dirname}/..`,
                changelogs: false,
                readmes: false,
                packages: [{ path: '.' }],
                typedocOptions: {
                    excludeExternals: false,
                },
                routeBasePath: '/reference',
            },
        ],
        ...config.plugins,
    ],

https://github.com/apify/apify-client-js/tree/master/website

B4nan avatar Oct 12 '23 11:10 B4nan

The generated typedoc JSON for the next version (right) is looking pretty much the same as the versioned ones (left):

image image

the docs are using TS 5.0.4, while the project itself is on TS 5.2.2

B4nan avatar Oct 12 '23 11:10 B4nan

Pretty sure this is caused by https://github.com/milesj/docusaurus-plugin-typedoc-api/issues/107#issuecomment-1789414073

milesj avatar Nov 01 '23 18:11 milesj