CarmineOptions
ODHack: Documentation
Write a chapter of documentation as a markdown file in docs/ directory. One chapter = one component. First study the code, then document how to use it and how to customize it, if applicable. This documentation should be aimed at protocols looking to use Konoha and assume knowledge of Cairo Components.
Expected skill level: Junior Cairo developer
This issue can be assigned to multiple persons, multiple people can work on different parts of the docs in parallel.
Definition of Done
The documentation is clear, readable, not obviously written by AI, documents all available customizations when using the component and give simple usage instructions.
Assignment
This issue will be assigned to multiple contributors as each works on their own chapter.
Assigned so far:
- airdrop @Joy-Adah
- proposals @raizo07
- token @AnoukRImola
- vesting @more-of-odeh
- upgrades @Ayoazeez26
- treasury @fishonamos
Could each of you select a specific chapter you would like to contribute first?
@AnoukRImola @raizo07 @Iwueseiter
@kateberryd @Gift-Naomi You can document the parts of the code you'll be working on and interacting with. If you wish to claim other parts, I will slightly prefer other contributors as you already have a task assigned.
Hy @tensojka can I get assigned a part of this one please,I haven't been assigned any task yet
@gidson5 Please select a specific chapter you would like to contribute first.
Okay @Joy-Adah , assigning you on the airdrop chapter. https://github.com/starknetfndn/defispring might come handy as that contract is similar and somehow documented.
@Xaxxoo No as that is not really an appropriate chapter for user-facing documentation.
@Xaxxoo No as that is not really an appropriate chapter for user-facing documentation.
Can I take types chapter ?
@gidson5 Please select a specific chapter you would like to contribute first
@tensojka Can I please work on the staking chapter?
@Xaxxoo
The types chapter is also not suited for user-facing documentation.
Given the recent misalignments with our documentation requirements, we will not assign you further tasks in Konoha.
@AnoukRImola you have been assigned the token chapter. Document both the voting token (locked) and the floating token please.
Note that I have now merged scaffolding for the mdbook in which you will work in #75 . I apologize for the delay, I haven't realized I didn't merge it
@AnoukRImola @raizo07 @Joy-Adah
@gidson5 Staking is not yet finished, I'm working on it, I will finish it in the next few days. Once the code is done, you can start working on the documentation.
@more-of-odeh Yes. Please coordinate with @Jemiiah who has #79 as streaming in vesting should be documented too.
@Ayoazeez26 Definitely yes, that's I would say the complex chapter. Make sure to document how custom proposals work. Refer to https://github.com/CarmineOptions/amm-governance for an example of a deployment of Konoha that uses custom proposals.
@gidson5 Staking is not yet finished, I'm working on it, I will finish it in the next few days. Once the code is done, you can start working on the documentation.
Alright cool.also it'll be nice if I'd be notified when it's ready so I can start.please
