When preparing the release 26.6, we noticed that the release scripts include the docs directory, but it is not in a usable form because building the auto-generated docs locally currently requires internal knowledge, and the misc directory with relevant scripts is excluded from the tarball.

For now, we decided to exclude "docs" from the release tarball because it promises more than it delivers. It would be nice to go the other way in the future and either

1) support building local docs as part of the build process that users run for tarball releases, or
2) include pre-generated docs in the tarballs