That issue made me realize I'm not sure why we have been using make-historical all this time rather than npm run gen-api with --historical. gen-api will correctly handle setting up the new folder. For Qiskit SDK, gen-api will ensure the release note links are updated correctly for the historical notes, like 1.2.mdx linking to /api/qiskit/1.2 rather than the unversioned files.
Closes https://github.com/Qiskit/documentation/issues/2269.
That issue made me realize I'm not sure why we have been using
make-historical
all this time rather thannpm run gen-api
with--historical
.gen-api
will correctly handle setting up the new folder. For Qiskit SDK,gen-api
will ensure the release note links are updated correctly for the historical notes, like1.2.mdx
linking to/api/qiskit/1.2
rather than the unversioned files.