milesj/docusaurus-plugin-typedoc-api

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

B4nan opened this issue · 3 comments

B4nan commented

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:

apify/apify-client-js#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 commented

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 commented

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

milesj commented

Pretty sure this is caused by #107 (comment)