Specify input build for deployment

[krillboi]

🚀 Feature

We would like to be able to specify an input for deployment - that is a folder with the whole documentation site built. This is because we would like to be able to:

• Build the documentation
• Then run some validation on that build
• Supply this build for deployment instead of the deploy script building the documentaion again

Have you read the Contributing Guidelines on issues?

Yes.

Motivation

Speed up our deployment steps.

Pitch

Would open up the deployment script more. Could be used like yarn deploy --input "path/to/build".

[lex111]

The docusaurus deploy command already has an option for this purpose, isn't that what you need? https://v2.docusaurus.io/docs/cli#docusaurus-deploy

[krillboi]

I might be misunderstanding something, but isn't that option just what the folder for the output should be?

What I would like is for there to be an input option, so you're effectively skipping the build step of the deploy script because you're supplying a build yourself.

Basically our own deploy script would be something like:

yarn build #builds documentation into /path/to/build
do_some_test_on_build() #run some validation on build
yarn deploy --input /path/to/build #deploy will not build here when using input because we already did so with yarn build

[lex111]

Fine, then we need a new option something like yarn deploy --skip-build, right?

[krillboi]

Yeah that would work as well.