docs: upgrade to nextra v3

[McAllaster]

This pull request updates nextra to version 3 (following the migration guide), and updates its dependencies.

Nextra had an odd issue with font rendering using the ss06 font feature settings on fonts which support it, causing issues with capital letters (see image below). It has since been resolved.

I am sure there are other changes that v3 introduced, but I did not notice any regressions in the documentation.

Note that v4 of nextra is available, but being fairly unfamiliar with it, I opted to only upgrade a single major version.

[McAllaster]

The README.md for docs has instructions to run the dev command, so I moved next dev to use that command instead of start.

[charmander]

with the caveat that I haven’t reviewed the 470 dependencies used in 20 static pages of documentation, and hope anyone attempting to render the docs is doing so in a suitable sandbox.

Thank you for fixing this longstanding bug!

[brianc]

Dang thanks for doing this! I'll review, test, and deploy if it all looks good. :)

[brianc]

Tried running the docs locally:

√ ~/src/node-postgres % yarn docs:start                                                                                     McAllaster-update-docs
yarn run v1.22.18
$ cd docs && yarn start
$ next start
Error: "next start" does not work with "output: export" configuration. Use "npx serve@latest out" instead.
    at /Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/next.js:209:31
    at async NextServer.prepare (/Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/next.js:153:24)
    at async initializeImpl (/Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/lib/render-server.js:91:5)
    at async initialize (/Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/lib/router-server.js:106:22)
    at async Server.<anonymous> (/Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/lib/start-server.js:221:36)
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

Doesn't work. Any tips would be appreciated here if you have time to look 👀 @McAllaster

I know it's been a long time. Sorry for the delay. Got a pretty intense job for a while I've now left.

[McAllaster]

Tried running the docs locally:

√ ~/src/node-postgres % yarn docs:start                                                                                     McAllaster-update-docs
yarn run v1.22.18
$ cd docs && yarn start
$ next start
Error: "next start" does not work with "output: export" configuration. Use "npx serve@latest out" instead.
    at /Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/next.js:209:31
    at async NextServer.prepare (/Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/next.js:153:24)
    at async initializeImpl (/Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/lib/render-server.js:91:5)
    at async initialize (/Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/lib/router-server.js:106:22)
    at async Server.<anonymous> (/Users/bmc/src/node-postgres/docs/node_modules/next/dist/server/lib/start-server.js:221:36)
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

Doesn't work. Any tips would be appreciated here if you have time to look 👀 @McAllaster

I know it's been a long time. Sorry for the delay. Got a pretty intense job for a while I've now left.

Looks like I forgot to update the top-level package.json to make the docs:start script point to the appropriate docs/package.json script. The next start command became incompatible with the output: export, and next dev replaced it.

Removed the non-working script as well to (hopefully) avoid confusion.

[brianc]

ah thanks - i'll take a look again today 🙌