docs theme

[casperdcl]

• use Furo theme (left & right nav bars, light & dark mode toggle)
• update URLs & metadata
• add Index to ToC
• add proper GitHub pages support
  • add docs/README.md instructions
  • remove deployed docs/build in favour of gh-pages branch
  • native config (.nojekyll, CNAME, etc.)
• rebuild site
  • compare: old (current) vs new (preview) merged; no longer relevant. old site branch (archived) vs new (live)
• update site location - https://iterative.github.io/PyDrive2/docs/build/html/index.html is horrible and really should be one of:

	URL convention	needs DNS config	future repos need DNS config
1 👍	https://docs.iterative.ai/PyDrive2/ <-- current winner	✅ (done 😁)	❌ 😁
2 😄	https://pydrive2.iterative.ai/	✅ 🙁	☑️ 😞
3 🎉	https://pydrive2.iterative.ai/docs/	✅ 🙁	☑️ 😞
4 ❤️	https://iterative.github.io/PyDrive2/	❌ 🙂	❌ 😁
5 🚀	https://iterative.github.io/PyDrive2/docs/	❌ 🙂	❌ 😁

vote using 👍/😄/🎉/❤️/🚀

[isidentical]

+1 on the (1) as well!

[skshetry]

I prefer (2) mostly, cml.iterative.ai, pydrive2.iterative.ai, dvc.iterative.ai, studio.iterative.ai, live.iterative.ai namespacing. It's easier to type, and provides better autocompletion.

(1) might be better for search engine ranking.

[shcheklein]

I think we need to do 2. If we do 1, we need to introduce some prefix like oss.iterative.ai/PyDrive2. iterative.ai is a corporate landing page, urls like iterative.ai/PyDrive2 look a bit strange there to be honest.

Can we move the docs into the branch also, as we discussed with you?

Is there preview available for this?

[casperdcl]

I think we need to do 2. If we do 1, we need to introduce some prefix like oss.iterative.ai/PyDrive2. iterative.ai is a corporate landing page, urls like iterative.ai/PyDrive2 look a bit strange there to be honest.

Option (1) is docs.iterative.ai/PyDrive2, not iterative.ai/PyDrive2!

Can we move the docs into the branch also, as we discussed with you?

Yes, just added to this PR.

Is there preview available for this?

prematurely deployed to https://iterative.github.io/PyDrive2/ for now :)

EDIT: removed (no easy way to preview)

EDIT: https://cdcl.ml/test/

[casperdcl]

rebased and non-squash-merged to keep a clean debuggable history in case of errors. Shallow clone transfer size reduced by 99.4% (compressed) or 97.3% (uncompressed) (!)

New docs site is live at https://docs.iterative.ai/PyDrive2.