Explorar o código

added docfx readme

Charlie Kindel %!s(int64=5) %!d(string=hai) anos
pai
achega
d1c53a3147
Modificáronse 1 ficheiros con 10 adicións e 0 borrados
  1. 10 0
      docfx/README.md

+ 10 - 0
docfx/README.md

@@ -0,0 +1,10 @@
+This folder generates the API docs for Terminal.Gui
+
+## To Generate the Docs
+
+1. Do a `Release` build on `master`. This will cause all `/// <inheritdoc/>` references to be updated.
+2. Change in to the `docfx/` directory.
+3. Type `docfx --metadata` to generate metadata
+4. Type `docfx --serve` to generate the docs and start a local webserver for testing.
+
+If `docfx` fails with a `Stackoverflow` error. Just run it again. And again. Sometimes it takes a few times. If that doesn't work, create a fresh clone or delete the `docfx/api`, `docfx/obj`, and `docs/` folders and run the steps above again.