Description
Background Info
While working with Swagger API docs, I ran into the term slots. I couldn’t find any explanation of it in our docs.
Instead I relied on Alchemy docs: https://docs.alchemy.com/docs/smart-contract-storage-layout
Suggested solution
Consider consolidating essential terms within core concept pages while providing concise definitions in the glossary.
Example: “Slots”
Instead of only defining 'Slots' in the glossary, follow Alchemy's way.
Find a main idea that covers 'Slots' well, like Alchemy did with smart contract storage layout. Still, add 'Slots' to the glossary, but also connect it to a bigger picture through a dedicated main idea page for better understanding.
Suggested Action Item(s)
- Manually reference Alchemy or other docs for key terms that are missing a definition & explanation #583
- Create a histogram to identify key terms #584
- Once terms are identified, further identify if we can connect them to a bigger picture through a dedicated main idea page for better understanding. In addition to adding them to the glossary. like Alchemy did with smart contract storage layout and the term slots #585
- Identify responsible teams/team members to help in this initiative #586
Note: This is a large initiative and cannot be completed in a single sprint; therefore, I recommend if this task gets approved to create smaller attainable tasks that lead to this ultimate goal.