Use theme to set all requirements for Crate Sphinx projects about crate-docs-theme

[amotl]

1. I created #295, crate/crate-tutorials#70 and crate/crate-jdbc#346 in order to work towards this goal.
2. I believe the dependencies on crate and croud will not do any harm.
3. Would leaving project-specific dependencies like sphinx-csv-filter for crate or sphinx-argparse for croud do any harm to this plan?

[nomicode]

1. sweet!! thanks so much
2. which dependencies? (i.e., what file or files are you referencing?)
3. yeah I think that's fine. should be no problem to leave those project-specific deps in there

[amotl]

@norosa: Do you believe we can close this ticket or is there some more work to do which I might be missing?

[nomicode]

@amotl take a look and let me know what you think. I'm happy to create the PRs and do the work to fix this issue. but I also thought you might like to take a shot? (i.e., to share knowledge/experience)

[amotl]

The crate-docs-theme should specify all requirements in the setup.py file and the Sphinx project-specific docs/requirements.txt file should only list a single dependency: crate-docs-theme (not pinned to any version, so the latest is always used).

I second this, let's make [1] the single source of truth. Shall we explictly say sphinx>=3.5.4,5 in setup.py then in order to retain the flexibility to evaluate it on Sphinx 4?

[1] https://github.com/crate/crate-docs-theme/blob/main/setup.py

[amotl]

In this context, I would also like to reference crate/crate-docs#52.

[amotl]

2. which dependencies? (i.e., what file or files are you referencing?)

Yeah, I actually meant those referenced at 3., apart from crate-docs-theme, at:

[2a] https://github.com/crate/crate/blob/master/docs/requirements.txt
[2b] https://github.com/crate/croud/blob/master/docs/requirements.txt

All set!

[nomicode]

@amotl thanks for all the work!