Rename in-toto/in-toto and in-toto/docs

[lukpueh]

The repositories names for the in-toto python implementation (in-toto) and for the in-toto specification (docs) are ambiguous and/or misleading. They can be easily mistaken for a project "landing page" (in-toto) or general project documentation (docs).

Proposed fix

• Rename docs to specification
• Rename in-toto to in-toto-python (like in-toto-golang, in-toto-java, in-toto-rs), or python-in-toto (like python-tuf, go-witness)
• Use language -typical doc platforms for API documentation (e.g. readthedocs, godoc, etc.)
• Use in-toto.io as project landing page and place for general project documentation
  • Repurposing in-toto or docs would be nice, but it seems safer to not reuse the names and instead use forwarding to preserve existing links
  • in-toto.io could include quick start guides with cli examples, where the used programming language doesn't matter (should probably only pick one of the (3!) co-existing in-toto cli)

[lukpueh]

If there's a consensus to do this, I'm happy to kick off the repo renames.

[acornforth]

Hey guys, just to add to this... I cam across this project on CNCF website, My Spanish-speaking partner laughed out loud, not believing this was the real name of an organisation....

In case you weren't aware, "toto" is how little girls refer to their girl parts in spain...

Not something one would ordinarily want to associate with "open and extensible", or "extensive tooling"... just saying.

https://www.spanishdict.com/translate/toto

[lukpueh]

• Rename docs to specification

Done!