Auto-publishing of documentation site is broken
Opened this issue · 1 comments
The auto-publishing of docs website has broken and no longer generates API docs correctly. The symptom is the same one as seen in #82. I have made a couple of attempts to fix this but in the mean-time I am manually publishing the docs instead.
In commit c23b46b I disabled the script within the .appveyor.yml file which auto-publishes the docs website, so that I could manually build and publish on my own environment. This ticket is to investigate the breakage, fix it and re-enable auto-publishing of the docs site from AppVeyor builds.
What could have broken this?
There are two main possibilities to investigate:
Work done during validator-validator
The work done during #33 was very large and long-running. It could have broken something.
The passage of time!
The last successful auto-publishing of the docs site was in 6f89da3, which is dated July 2022. The next attempt after #33 was done was not until February 2023 in commit d81bcce, which is the first bad commit. In that time, .NET 7 was added to AppVeyor build images. That might also have something to do with it.
See this info on the DocFX site. The technique I was using has been withdrawn.