Documentation pass: building and API docs

[robertodr]

Improve XCFun docs for the API (currently confusing/outdated) and for building (completely outdated)

Squash-merge please, we don't need to keep the history for this PR.

To build locally, you need Doxygen, Sphinx, and Breathe installed. Either from the root folder of the repo with:

sphinx-build docs _build -t html

or from the docs folder with:

make html

@bast I think the documentation on dftlibs.org is completely outdated and can be safely decommissioned.

Close #32, close #4, close #88

Todos

• Developer Interest
  • [X] Autodocument API with Breathe for the Sphinx-Doxygen bridge
  • [X] First draft of how to use documentation
  • [X] Write how to build documentation

Status

• [x] Ready to go

[codecov-io]

Codecov Report

Merging #106 into master will not change coverage. The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #106   +/-   ##
=======================================
  Coverage   52.99%   52.99%           
=======================================
  Files          78       78           
  Lines        1970     1970           
=======================================
  Hits         1044     1044           
  Misses        926      926

Impacted Files	Coverage Δ
src/XCFunctional.cpp	65.65% <ø> (ø)	:arrow_up:
src/config.hpp	0% <ø> (ø)	:arrow_up:
tests/testall.cpp	91.97% <ø> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more Δ = absolute <relative> (impact), ø = not affected, ? = missing data Powered by Codecov. Last update 630fdee...6d7fd7d. Read the comment docs.

[bast]

@bast I think the documentation on dftlibs.org is completely outdated and can be safely decommissioned.

I will take care of that one.

[robertodr]

@bast I think the documentation on dftlibs.org is completely outdated and can be safely decommissioned.

I will take care of that one.

Maybe we can set up a redirect to readthedocs?

[bast]

@bast I think the documentation on dftlibs.org is completely outdated and can be safely decommissioned.

I will take care of that one.

Maybe we can set up a redirect to readthedocs?

Redirect is now in place: https://dftlibs.org