Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation and overall project readability is lacking #129

Open
Alexangelj opened this issue Nov 18, 2020 · 0 comments
Open

Documentation and overall project readability is lacking #129

Alexangelj opened this issue Nov 18, 2020 · 0 comments
Labels
documentation Improvements or additions to documentation enhancement New feature or request priority A priority issue to take care of. security Changes are related to security of contracts.

Comments

@Alexangelj
Copy link
Contributor

The Primitive protocol contracts live as different versions, with different parts scattered about. It's confusing, what's in use right now? What's being used? What's being thrown away?

There needs to be consistent documentation and guides for developers to interact with the protocol, and for third party security experts to be able to easily examine the production code.

Defi Safety has a great list of basic to do items. These should all be done.

Open Zeppelin has a good checklist

There should be consistency between the documentation, website, and github repo. The source of truth should always be the docs! Documentation should link to the implementation code.

There should be individual (small) guides on how to use each function of the protocol/what they do.

@Alexangelj Alexangelj added documentation Improvements or additions to documentation enhancement New feature or request security Changes are related to security of contracts. priority A priority issue to take care of. labels Nov 18, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request priority A priority issue to take care of. security Changes are related to security of contracts.
Projects
None yet
Development

No branches or pull requests

1 participant