Rewrite documentation

[MattiSG]

The README of this repository was initially created as a the first public presence of Open Terms Archive, before a website was even created. It contains a mix of political statements, user documentation and technical documentation, and is overall obsolete. Beyond outdated contents, the growth of the ecosystem, the maturity of the website and the architectural choices of moving slowly from a monolithic system to a more modular approach to keep the code maintainable, all mean that the documentation should now be focused on the technical aspects of the engine, and the user documentation kept separate.

This changeset:

• Rewrites the entirety of the README to remove outdated information and focus it on the technical aspects of the engine.
• Creates a docs folder containing user documentation, that will be at some point moved to the recently created OpenTermsArchive/docs. This documentation is consolidated from different parts of this repository and other relevant repositories,
• Removes the outdated French translation of the user documentation parts of the README.

If merged, the following subsequent actions should be taken:

• Remove the documentation from contrib-declarations.
• Update links to the documentation in each collection README.

---

Co-authored with @Ndpnt.

Fixes #811 #963.

Relates to OpenTermsArchive/contrib-declarations#696 (comment)

Depends on OpenTermsArchive/contrib-declarations#746.

[clementbiron]

I have some feedback but nothing blocking, well done!

[clementbiron]

It doesn't really matter but I'm curious to know what is the reason for this change in the format of <hr />?

As a reminder, markdown files will be linted when they are migrated to the docs repository, and the following rule will apply: https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md035---horizontal-rule-style

[MattiSG]

I personally prefer using the style with spaces for horizontal ruler, because it is unambiguous with the underline title style:

This is not a title.

---
This is under a ruler.

is less clear to me than

This is not a title.

- - -
This is under a ruler.

and in case of a forgotten whitespace, this will still render as a ruler:

This is not a title.
- - -
This is under a ruler.

whereas this won't:

This is not a title (but is rendered as such)
---
This is under a ruler.

---

As for rule MD035, we can define the string to whatever we want, so if you agree with my point of view we could very well define it to - - - 🙂

[clementbiron]

Why not simplify the naming of the file by governance.md ?

[MattiSG]

#971 (comment)

[clementbiron]

Why the file is named howto-... and not how-to-... ? (it may be that my English is not good enough)

[MattiSG]

As explained in #971 (comment), the idea was to have categories as prefixes, thus making them stand in a single “namespace” of sorts. I agree this could be improved.

[MattiSG]

@Ndpnt I renamed “document type” to “terms type” everywhere except in code in 9049cd3, please let me know if you'd prefer that we delay this and have a single changeset with codebase, CLI, API and documentation as part of implementing #964.