DM-42680: Add initial implementation of documentation workflow

[JeremyMcCormick]

Build the documentation using a compatible version of documenteer and upload for triggers other than PRs. For PRs, the documentation will be built but not uploaded. The README was the same as the documentation site, so it has been replaced by a more minimal text.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (6701e0e) 93.36% compared to head (95ebc4b) 93.36%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #38   +/-   ##
=======================================
  Coverage   93.36%   93.36%           
=======================================
  Files          20       20           
  Lines        2109     2109           
  Branches      425      425           
=======================================
  Hits         1969     1969           
  Misses         81       81           
  Partials       59       59           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[gpdf]

One small change requested

[gpdf]

Could you move this to the top of the README, maybe as something like:

"Detailed information on usage, customization, and design is available at the Felis documentation site."

(since the sentence as it stands will read awkwardly if moved to the top unchanged)

[JeremyMcCormick]

@gpdf Let's do a re-review of this PR. I replaced the README.md with README.rst and added some additional sections. You can view the new README here.

I don't think we should immediately link to the documentation site at the top, because it is already listed in the sidebar. The documentation as it exists is also not a good starting point for users to learn about the tool, as it starts with an overly discursive section and needs a pretty major overhaul. Maybe we could revisit this in the future once the actual site is in better shape and makes a better entry point for information? (I've still linked to it, just in a section that is closer to the bottom of the new README after the summary section. This is actually a similar README layout to several other popular tools like SQLAlchemy.)

[gpdf]

OK to proceed