Disable API in versioned docs

[fgatti675]

Hi, me again :) My docusaurus project has 3 versions, and I only want to generate the API for the latest one. I would like to leave older versions as they are. If I don't add versioned APIs, I get the error:

[cause]: Error: ENOENT: no such file or directory, open '/website/versioned_docs/version-2.0.0/api-packages.json'

If I generate that file with yarn docusaurus api:version 2.0.0 I get an error for each different API item:

 Error: Can't render static file for pathname "/docs/api/next/function/getValueInPath"

(note that is using next instead of 2.0.0 which is the version name, there are no references to next anywhere in my codebase)

I don't need the API in older versions and would rather have it disabled. Is it possible? Thanks!

[fgatti675]

Alternative, I have been trying to simply create a placeholder of the config json files to make the plugin happy, but no luck. Would you have some examples by any chance? Thanks!

[milesj]

This plugin piggy-backs off docusaurus's official versioning system, so we don't really have much control over it.

However, docusuaurus supports a few options that the plugin inherits, that maybe can work here? They are disableVersioning, onlyIncludeVersions, lastVersion, and a few others.

[sedghi]

I'm facing the same issue. I don't want to completely disable the API in my older version, but I'd like to make it functional so it displays something.

Currently, when I run yarn run docusaurus docs:version 1.0, it creates a version but doesn't transfer the API-related content.

The next time (after versioning) I run docusaurus (yarn start), it throws an error stating it can't find api-packages.json.

I considered locating that JSON file and manually copying it to the versioned_docs folder, but I can't find it anywhere.

@milesj, do you know where this file is being saved? I've checked inside the .docusaurus folder, but it's not there.

Here is my docusaurus config

Update : If i just dummy create the two files it complains about (api-packages.json and api-typedoc.json) and put them inside the packages/docs/versioned_docs/version-1.0 it successfully compiles, but my current docs (not versioned) lose the api