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

Improvements: Documentation #194

Open
4 tasks
kcalvinalvin opened this issue Sep 2, 2020 · 1 comment · May be fixed by #324
Open
4 tasks

Improvements: Documentation #194

kcalvinalvin opened this issue Sep 2, 2020 · 1 comment · May be fixed by #324

Comments

@kcalvinalvin
Copy link
Member

kcalvinalvin commented Sep 2, 2020

At the moment, the documentation is still less than ideal. The lack of it is hurting the ability for newcomers to use/contribute to the project. These are things to work on.

The priority of these should be mid-term, so around a month or two to get these done.

Documentation for the new contributor

  • Technical explanation of the accumulator.

    While there are some limited explainers for each individual component of the accumulator code, there hasn't ever been an explainer for how the flow of the code is done, or how Pollard and Forest is structured, nor how proof checking is done, etc. This seems to cause confusion judging by the questions asked by newcomers to the project. A good technical documentation should help this.

    It doesn't need to be as detailed as this documentation by rocksdb but something along this style in a separate docs/ directory should be good.

  • Contributing guidelines.

    This guideline should include things as:
    a. Minimum supported go version
    b. Code Documentation and Commenting (maybe just take this from lnd)
    c. Running go vet and go fmt before submitting a PR.
    d. Git commit guidelines (maybe just take from lnd again)

  • IRC backup logs.

    gnusha has been experiencing downtimes and we do need a backup. The missing IRC logs end up in lost discussions.

  • Notes for meeting calls

    These calls are inaccessible by many and the discussions/knowledge is lost after the calls. I'll start jotting down notes and have a log of important things that were discussed in the meeting call.

@sloorush
Copy link
Contributor

sloorush commented Sep 7, 2021

For tasks 1 and 2, I was thinking of something like this:

  1. Explanation of utreexo
  2. How to run + FAQ for first-timers
  3. Style guide (similar to the one that already exists)
  4. Contributing guidelines
  5. Featured Links (like all good articles/resources/videos/podcasts for utreexo)
  6. Details about UTCD and dergoegge/bitcoin.
  7. Improved Readme

@sloorush sloorush linked a pull request Sep 27, 2021 that will close this issue
7 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants