Setup DocFx and Getting Started docs

[apexdodge]

Did some rudimentary testing with DocFX and it was easy to get started.

https://dotnet.github.io/docfx/index.html

I ran it on the Raytha.Application project and it did a thorough job of picking up literally everything.

Need to learn how to properly format and clean it up.

Ideally, the left side navigation is simply:

• Admins

  • Commands.CreateAdmin
  • Commands.DeleteAdmin
  • Commands.EditAdmin
  • Queries.GetAdminById
  • Queries.GetAdmins
  • EventHandlers.AdminCreatedEventHandler
  • EventHandlers.AdminPasswordResetEventHandler

• ContentItems

  • Commands.CreateContentItem
  • Commands.DeleteContentItem

...etc, etc, basically just the business layer actions, nicely organized.

I created a branch called docfx

[apexdodge]

DocFx is kind of difficult to work with, but I solved the main challenge I was going for:

Remaining tasks:

• Finish creating the left side nav links
• Migrate some basic articles such as installation, SSO w/ JWT, SSO w/ SAML
• Add github action to automatically build and publish docs

[apexdodge]

Got it working with github actions that builds and deploys the static site to a gh-pages branch and also custom domain:

https://docs.raytha.com/index.html

Still need to add getting started and other pages.

[apexdodge]

Good progress on docs.

Remaining articles:

• Templates
• Build a JWT sso
• Build a SAML sso
• Reference doc intro

[apexdodge]

To be released with v1.0.4