docs: release as asset

[viceice]

Changes:

Do the docs preparation step from https://github.com/renovatebot/renovatebot.github.io here and package files as release asset.

Context:

Documentation (please check one with an [x])

• I have updated the documentation, or
• No documentation update is required

How I've tested my work (please tick one)

I have verified these changes via:

• Code inspection only, or
• Newly added/modified unit tests, or
• No unit tests but ran on a real repository, or
• Both unit tests + ran on a real repository

[HonkingGoose]

I think I'm doing something wrong, or my setup is wrong somehow...

I first tried a normal build, that seems to work OK:

$ yarn build
yarn run v1.22.11
$ run-s clean generate:* compile:*
$ rimraf dist
$ node tools/generate-imports.mjs
generating imports
> data/extract.py
> data/node-js-schedule.json
> node_modules/emojibase-data/en/shortcodes/github.json
$ tsc -p tsconfig.app.json
Done in 11.38s.

Then I tried to build the docs, which seems to go wrong somehow. I don't see any new output in the tmp directory.

$ yarn build:docs
yarn run v1.22.11
$ run-s "release:prepare {@}"
$ node -r ts-node/register/transpile-only -- tools/generate-docs.ts
 INFO: generating docs
 INFO: * static
cp: dest is not a directory (too many sources)
Done in 6.37s.

What commands should I run to test this locally, and do you expect me to see, and where should I see the new files?

[viceice]

• yarn clean should clean docs now
• yarn build:docs shouuld work as expected now

yarn build isn't required for building docs

[HonkingGoose]

yarn build isn't required for building docs

Oh I thought maybe you need to build the Renovate program first, so that we have things ready for the build:docs step.

I'll try this out locally later this day.

[HonkingGoose]

When I run yarn build:docs I get 3 WARN messages.

$ yarn build:docs
yarn run v1.22.11
$ run-s "release:prepare {@}"
$ node -r ts-node/register/transpile-only -- tools/generate-docs.ts
 INFO: generating docs
 INFO: * static
 INFO: * modules
 INFO: * platforms
 INFO: * versionigs
 INFO: * datasources
 INFO: * managers
 INFO: * presets
 WARN: Preset compatibility:additionalBranchPrefix has no description
 WARN: Preset helpers:disableTypesNodeMajor has no description
 WARN: Preset workarounds:mavenCommonsAncientVersion has no description
 INFO: * templates
 INFO: * configuration-options
 INFO: * self-hosted-configuration
 INFO: * json-schema
Done in 6.63s.

I've checked the source files, and we are missing descriptions for these presets. Do we need to add them?

[viceice]

We don't need them, but we should add them 🙃

[viceice]

working on it, it was just the merge on main, needs some adaptions now

[viceice]

diff can be generated via:

diff -Naur renovatebot.github.io/docs/ renovate/tmp/docs -x CNAME -x LICENSE -x README -x *.css -x *.js -x index.md -x merge-confidence.md

[viceice]

You don't need to verify, you can trust my diff posted on slack. 😉

[viceice]

Do we have a ready PR to trigger a release. 🤭

[renovate-release]

🎉 This PR is included in version 30.1.0 🎉

The release is available on:

• GitHub release
• 30.1.0

Your semantic-release bot 📦🚀