google / trillian

A transparent, highly scalable and cryptographically verifiable data store.
Apache License 2.0
3.51k stars 375 forks source link

Rewrite README to be more user-focused #1357

Open RJPercival opened 5 years ago

RJPercival commented 5 years ago

A sizeable portion of the README is currently dedicated to information only useful to developers working on the code. Instead, we should rewrite it to only contain information that users need. We can link to a separate document that covers what contributors need to know.

Information that the README should contain:

Information that should be moved out of the README:

pav-kv commented 3 years ago

I'm not sure that the main README should have that level of detail at all, esp. the architectural diagrams. Esp. Kubernetes!

I think it should be just an index of various things. An example of a good README from my PoV: https://github.com/cockroachdb/cockroach.

AlCutter commented 2 years ago

1660 is related, we should make sure that the admin actions (e.g. creating trees) are part of the user docs.