Beem 0.20.10 - Fixing lots of documentation syntax errors and typos
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
- https://beem.readthedocs.io/en/latest/beem.account.html
- https://beem.readthedocs.io/en/latest/beem.amount.html
- https://beem.readthedocs.io/en/latest/beem.asciichart.html
- https://beem.readthedocs.io/en/latest/beem.asset.html
- https://beem.readthedocs.io/en/latest/beem.block.html
- https://beem.readthedocs.io/en/latest/beem.blockchain.html
- https://beem.readthedocs.io/en/latest/beem.comment.html
- https://beem.readthedocs.io/en/latest/beem.discussions.html
- https://beem.readthedocs.io/en/latest/beem.exceptions.html
- https://beem.readthedocs.io/en/latest/beem.imageuploader.html
- https://beem.readthedocs.io/en/latest/beem.instance.html
- https://beem.readthedocs.io/en/latest/beem.market.html
- https://beem.readthedocs.io/en/latest/beem.memo.html
- https://beem.readthedocs.io/en/latest/beem.message.html
- https://beem.readthedocs.io/en/latest/beem.nodelist.html
- https://beem.readthedocs.io/en/latest/beem.notify.html
- https://beem.readthedocs.io/en/latest/beem.price.html
- https://beem.readthedocs.io/en/latest/beem.snapshot.html
- https://beem.readthedocs.io/en/latest/beem.steem.html
- https://beem.readthedocs.io/en/latest/beem.steemconnect.html
- https://beem.readthedocs.io/en/latest/beem.storage.html
- https://beem.readthedocs.io/en/latest/beem.transactionbuilder.html
- https://beem.readthedocs.io/en/latest/beem.vote.html
- https://beem.readthedocs.io/en/latest/beem.wallet.html
- https://beem.readthedocs.io/en/latest/beem.witness.html
- https://beem.readthedocs.io/en/latest/beembase.signedtransactions.html
- https://beem.readthedocs.io/en/latest/beemgraphenebase.account.html
- https://beem.readthedocs.io/en/latest/beemgraphenebase.base58.html
- https://beem.readthedocs.io/en/latest/beemgraphenebase.signedtransactions.html
- https://beem.readthedocs.io/en/latest/cli.html
- https://beem.readthedocs.io/en/latest/configuration.html
- https://beem.readthedocs.io/en/latest/contribute.html
- https://beem.readthedocs.io/en/latest/modules.html
- 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 :-)
Hello @flugschwein,
Welcome to the documentation category as this is your first contribution since I have become CM.
As this contribution was related to typos but minor fixes it is not scored high.
But I highly appreciate the efforts you have put into it to make the Beem docs better.
I really love the passion you have for the project.
Keep contributing.
I am already looking forward to the next documentation contribution from you.
Your contribution has been evaluated according to Utopian policies and guidelines, as well as a predefined set of questions pertaining to the category.
To view those questions and the relevant answers related to your post, click here.
Need help? Write a ticket on https://support.utopian.io/.
Chat with us on Discord.
[utopian-moderator]
Thanks for your review!
Let's see if I can spend some more time on the beem documentation :-)
Thank you for your review, @ms10398! Keep up the good work!
Nicely formatted post :) Easy to read.
Thanks a lot. I actually feared the opposite xD
If I could turn back !BEER
Hi @flugschwein!
Your post was upvoted by @steem-ua, new Steem dApp, using UserAuthority for algorithmic post curation!
Your post is eligible for our upvote, thanks to our collaboration with @utopian-io!
Feel free to join our @steem-ua Discord server
Hey, @flugschwein!
Thanks for contributing on Utopian.
We’re already looking forward to your next contribution!
Get higher incentives and support Utopian.io!
Simply set @utopian.pay as a 5% (or higher) payout beneficiary on your contribution post (via SteemPlus or Steeditor).
Want to chat? Join us on Discord https://discord.gg/h52nFrV.
Vote for Utopian Witness!
Congratulations @flugschwein! You have completed the following achievement on the Steem blockchain and have been rewarded with new badge(s) :
Click here to view your Board of Honor
If you no longer want to receive notifications, reply to this comment with the word
STOP
Do not miss the last post from @steemitboard:
Congratulations! This post has been upvoted from the communal account, @minnowsupport, by Flugschwein from the Minnow Support Project. It's a witness project run by aggroed, ausbitbank, teamsteem, someguy123, neoxian, followbtcnews, and netuoso. The goal is to help Steemit grow by supporting Minnows. Please find us at the Peace, Abundance, and Liberty Network (PALnet) Discord Channel. It's a completely public and open space to all members of the Steemit community who voluntarily choose to be there.
If you would like to delegate to the Minnow Support Project you can do so by clicking on the following links: 50SP, 100SP, 250SP, 500SP, 1000SP, 5000SP.
Be sure to leave at least 50SP undelegated on your account.
Just admirable!!
Congratulations @flugschwein! You have completed the following achievement on the Steem blockchain and have been rewarded with new badge(s) :
Click here to view your Board of Honor
If you no longer want to receive notifications, reply to this comment with the word
STOP
Do not miss the last post from @steemitboard:
Congratulations @flugschwein! You have completed the following achievement on the Steem blockchain and have been rewarded with new badge(s) :
Click here to view your Board of Honor
If you no longer want to receive notifications, reply to this comment with the word
STOP
Do not miss the last post from @steemitboard: