Skip to content
This repository has been archived by the owner on Jan 13, 2023. It is now read-only.

Improve PyOTA documentation #268

Closed
7 tasks done
lzpap opened this issue Nov 19, 2019 · 1 comment
Closed
7 tasks done

Improve PyOTA documentation #268

lzpap opened this issue Nov 19, 2019 · 1 comment
Assignees

Comments

@lzpap
Copy link
Member

lzpap commented Nov 19, 2019

After the first iteration of docs update #260 that dealt with API commands, continue the process of making the documentation more readable for users and improve it in general.

Specific areas to improve:

  • Add high-level explanation of IOTA concepts that link to the official docs site.
  • Explain the PyOTA data types and their implementation details. It should be clear what is used for what, and how. For example, document TryteString class and its sub-classes and include examples how to use them.
  • Improve documentation on how address generation works in PyOTA, with actual scenarios that show the corner cases, after snapshot problem, etc.
  • Explain adapters, how are they used and what happens upon API command execution.
  • Document filters.
  • Add tutorials, examples at the end about frequently used operations or popular use case scenarios. Maybe include the python community workshop with some extended examples?
  • Make the documentation more visually appealing by including pictures. For example, to demonstrate the process of sending a transaction from scratch like this pic does, or to show what options a user has to construct a bundle like this.

Ideas and feedback on how to improve the docs are more than welcome! 👋

@lzpap
Copy link
Member Author

lzpap commented Mar 6, 2020

Closing the issue as the original scope is fulfilled.

@lzpap lzpap closed this as completed Mar 6, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

1 participant