docs

.github/workflows/build-and-publish-docs.yml

@@ -31,7 +31,7 @@ jobs:
       - name: Upload docs artifact to GH pages
         uses: actions/upload-pages-artifact@v2
         with:
-          path: ./output
+          path: ./.docsOutput
 
   deploy:   
     runs-on: ubuntu-latest

.gitignore

@@ -338,5 +338,5 @@ ASALocalRun/
 
 # fsdocs
 tmp/
-output/
+.docsOutput/
 .fsdocs/

README.md

@@ -92,7 +92,7 @@ For common tasks, there are powershell files located in the repo root:
 * `./test.ps1`: Runs all tests (sources in `./src/Tests`).
   * You can pass args to this task. E.g. for executing only some tests:
     `./test.ps1 --filter Name~'Response Decompression'`
-* `./docu.ps1`: Rebuilds the FsHttp documentation site (sources in `./src/docs`; output goes to `./docs`).
+* `./docu.ps1`: Rebuilds the FsHttp documentation site (sources in `./src/docs`).
 * `./docu-watch.ps1`: Run it if you are working on the documentation sources, and want to see the result in a browser.
 * `./publish.ps1`: Publishes all packages (FsHttp and it's integration packages for Newtonsoft and FSharp.Data) to NuGet.
   * Always have a look at `./src/Directory.Build.props` and keep the file up-to-date.

docs/index.md

@@ -112,7 +112,7 @@ For common tasks, there are powershell files located in the repo root:
 * `./test.ps1`: Runs all tests (sources in `./src/Tests`).
   * You can pass args to this task. E.g. for executing only some tests:
     `./test.ps1 --filter Name~'Response Decompression'`
-* `./docu.ps1`: Rebuilds the FsHttp documentation site (sources in `./src/docs`; output goes to `./docs`).
+* `./docu.ps1`: Rebuilds the FsHttp documentation site (sources in `./src/docs`).
 * `./docu-watch.ps1`: Run it if you are working on the documentation sources, and want to see the result in a browser.
 * `./publish.ps1`: Publishes all packages (FsHttp and it's integration packages for Newtonsoft and FSharp.Data) to NuGet.
   * Always have a look at `./src/Directory.Build.props` and keep the file up-to-date.

docu.ps1

@@ -35,4 +35,5 @@ dotnet fsdocs `
     --properties Configuration=Release TargetFramework=net8.0 `
     --sourcerepo https://github.com/fsprojects/FsHttp/blob/master/src `
     --parameters root /FsHttp/ `
-    --strict
+    --strict `
+    --output ./.docsOutput