initial sphinx

[rpwils]

initial sphinx

[ed-nykaza]

@rpwils I found a few typos, and was not able to run build clean. I am going to approve the pull request so we can keep moving forward, but I'm thinking that a walkthrough of how this works, might be worthwhile. (cc: @jameno)

[jameno]

We'll want to add a .gitignore file with the following:

# Environments
.env
# General
.DS_Store
data
export
# Python
__pycache__

[jameno]

I did get this code to run (hurrah!) but we have some duplicate files and can rearrange some things. It looks like the Makefile's SOURCEDIR is building from donor-data-pipeline/docsrc/docsrc. I think the build could be done from a single folder with a flat set of files.

My suggestion is that the folder structure looks like this:

donor-data-pipeline/
├── docsrc/
│   ├── Makefile
│   ├── README.md
│   ├── simple_test.rst
│   ├── conf.py
│   ├-── index.rst
│   └── make.bat

I made some comments/suggestions on files in both docsrc and docsrc/docsrc. Let me know if you have any questions!

[jameno]

If we keep all files at the same level within a single donor-data-pipeline/docsrc folder, then sys.path.insert(0, os.path.abspath("..")) should solve this as well.