Statiq programs always returns 0, even when errors occurred

[girlpunk]

With the current example code, Statiq programs always return exit code 0. This means that CI/CD pipelines and other deployment methods are unable to automatically detect that something went wrong, and may proceed with trying to deploy the site anyway.

An easy solution to this is to change the example code to return the exit code that Statiq generates. For example, the current Statiq.Docs example code:

await Bootstrapper
    .Factory
    .CreateDocs(args)
    .RunAsync();

is easily changed to

return await Bootstrapper
    .Factory
    .CreateDocs(args)
    .RunAsync();

Is it worth changing the suggested code in the relevant places to make troubleshooting and automated deployment of Statiq sites easier?

[daveaglick]

You're absolutely right, all examples should be returning the exit code. Going through the documentation, I'm trying to find anywhere that it's not - I'm assuming you're talking about things like the partial second code sample here (as opposed to the first example, which does return the result code)?

[daveaglick]

FYI - I went through and scrubbed the docs for situations like this and added return statements to all the ones I found, thanks a lot for the suggestion: statiqdev/Website@543b163

[girlpunk]

Yes, sorry I should have clarified which example I used. Thanks!