Repository
https://github.com/holgern/beem
Details
Write details of the new/updated official documentation, highlighting all the important changes and additions made.
Looking through the beem documentation, I noticed there were many small things not quite looking like they should. I tried to get the existing documentation to build with no error, and to get it to display like it should. For example, instead of looking like that:
things looked like this:
You'll see that the parameters did not get parsed correctly, and caused the whole paragraph to include some semi-readable text.
Similar errors in the Sphinx Syntax and general typos were fixed by me. There also is a feature by Sphinx that makes linking to other parts of the documentation very comfortable. I applied this to I think all places where this can be applied. This greatly improves the comfort in using the documentation in my opinion (when you can jump right to the documentation of the mentioned classes/functions).
Further examples: (click on the images to view them full screen)
|Before|After|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Nearly all of the changes are similar to those in the above screenshots.
After my changes, the documentation no longer displays any warning when building. I already fixed quite a lot of warnings in this Pull Request some time ago.
Components
The changes I made were spread pretty much all over the documentation. Most of the changes are in parts of the module, that got created or edited after the "birth" of beem.
Links
I changed the following pages of the beem documentation 1. https://beem.readthedocs.io/en/latest/beem.account.html 2. https://beem.readthedocs.io/en/latest/beem.amount.html 3. https://beem.readthedocs.io/en/latest/beem.asciichart.html 4. https://beem.readthedocs.io/en/latest/beem.asset.html 5. https://beem.readthedocs.io/en/latest/beem.block.html 6. https://beem.readthedocs.io/en/latest/beem.blockchain.html 7. https://beem.readthedocs.io/en/latest/beem.comment.html 8. https://beem.readthedocs.io/en/latest/beem.discussions.html 9. https://beem.readthedocs.io/en/latest/beem.exceptions.html 10. https://beem.readthedocs.io/en/latest/beem.imageuploader.html 11. https://beem.readthedocs.io/en/latest/beem.instance.html 12. https://beem.readthedocs.io/en/latest/beem.market.html 13. https://beem.readthedocs.io/en/latest/beem.memo.html 14. https://beem.readthedocs.io/en/latest/beem.message.html 15. https://beem.readthedocs.io/en/latest/beem.nodelist.html 16. https://beem.readthedocs.io/en/latest/beem.notify.html 17. https://beem.readthedocs.io/en/latest/beem.price.html 18. https://beem.readthedocs.io/en/latest/beem.snapshot.html 19. https://beem.readthedocs.io/en/latest/beem.steem.html 20. https://beem.readthedocs.io/en/latest/beem.steemconnect.html 21. https://beem.readthedocs.io/en/latest/beem.storage.html 22. https://beem.readthedocs.io/en/latest/beem.transactionbuilder.html 23. https://beem.readthedocs.io/en/latest/beem.vote.html 24. https://beem.readthedocs.io/en/latest/beem.wallet.html 25. https://beem.readthedocs.io/en/latest/beem.witness.html 26. https://beem.readthedocs.io/en/latest/beembase.signedtransactions.html 27. https://beem.readthedocs.io/en/latest/beemgraphenebase.account.html 28. https://beem.readthedocs.io/en/latest/beemgraphenebase.base58.html 29. https://beem.readthedocs.io/en/latest/beemgraphenebase.signedtransactions.html 30. https://beem.readthedocs.io/en/latest/cli.html 31. https://beem.readthedocs.io/en/latest/configuration.html 32. https://beem.readthedocs.io/en/latest/contribute.html 33. https://beem.readthedocs.io/en/latest/modules.html 34. https://beem.readthedocs.io/en/latest/quickstart.html
GitHub Proof of Authorship
- GitHub Account: https://github.com/flugschwein
- Pull Request: https://github.com/holgern/beem/pull/111 As of the posting of this post, the changes I made haven't gone live yet. They are already merged into the master branch though Edit: It's live now :-)