NightOwl888 opened a new issue, #1004: URL: https://github.com/apache/lucenenet/issues/1004
### Is there an existing issue for this? - [X] I have searched the existing issues ### Describe the bug The automation doesn't work because the `docs.ps1` script makes assumptions that aren't true in CI: 1. The docfx tool is already installed, so a dotnet tool restore will function 2. The docfx command is on the path ### Expected Behavior 1. docs.ps1 will install docfx if it doesn't already exist 2. docs.ps1 won't rely on the system path, which isn't stable across environments. Instead, it should use `--tool-path` to set the install location, and use the same location (absolute path) to execute the tool. 3. docs.ps1 should install docfx in a versioned folder so future versions of the script can execute on the same machine as the current version ### Steps To Reproduce Run the workflow at: https://github.com/apache/lucenenet/actions/workflows/Lucene-Net-Documentation.yml on the master branch. ### Exceptions (if any) https://github.com/apache/lucenenet/actions/runs/11490755057 Workload updates are available. Run `dotnet workload list` for more information. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.codecs.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.core.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.analysis-common.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.analysis-kuromoji.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.analysis-morfologik.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.analysis-opennlp.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.analysis-phonetic.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.analysis-smartcn.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.analysis-stempel.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.benchmark.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.classification.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.expressions.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.facet.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.grouping.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.icu.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.highlighter.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.join.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.memory.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.misc.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.queries.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.queryparser.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.replicator.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.sandbox.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.spatial.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.suggest.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.test-framework.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.demo.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.codecs.json... Cannot find a tool in the manifest file that has a command named 'docfx'. Building api metadata for D:\a\lucenenet\lucenenet\main-repo\websites\apidocs\docfx.core.json... Cannot find a tool in the manifest file that has a command named 'docfx'. ### Lucene.NET Version N/A ### .NET Version N/A ### Operating System windows-latest ### Anything else? _No response_ -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: dev-unsubscr...@lucenenet.apache.org.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
