[RFE] Explain tables in Aptos

[clay-aptos]

RFE

Tables are a common area of confusion in Aptos. We should explain them, building upon a definition proposed in:
#5434

See the sources we have now:
https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/framework/aptos-stdlib/sources/table.move
https://aptos.dev/guides/move-guides/guide-move-transactional-testing/#view-tables
https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/framework/aptos-stdlib/doc/table.md#0x1_table

Note, the second link isn't in navigation. We should fix that too. Asking @banool and @movekevin for guidance and help.

[crazybits]

how to deserialize table from raw bytes to rust struct with bcs,any sample for reference?

[clay-aptos]

Thanks to Daniel, we also have:
https://stackoverflow.com/questions/74296605/given-a-key-how-do-i-read-the-value-from-a-table-via-the-api

[clay-aptos]

I have started a glossary entry for Table here:
#5897

And I am linking to @banool 's excellent Stack Overflow answer here:
https://stackoverflow.com/questions/74296605/given-a-key-how-do-i-read-the-value-from-a-table-via-the-api

I would love to publish these instructions, still not in site navigation:
https://aptos.dev/guides/move-guides/guide-move-transactional-testing/#view-tables

Team, please advise. Thanks!

[clay-aptos]

We have removed the Stack Overflow link. Please take another look:
#5897

[clay-aptos]

We are live!
https://aptos.dev/reference/glossary#table

Closing this out as all I could muster here. If someone else wants to contribute, I'd love that.

[clay-aptos]

Reopening to see if we can get more details in the docs.

[wrwg]

What is about the reference docs generated from the source?

[clay-aptos]

What is about the reference docs generated from the source?

This?
https://github.com/aptos-labs/aptos-core/blob/main/aptos-move/framework/aptos-stdlib/doc/table.md

We link from:
https://aptos.dev/reference/glossary#table

Yet I don't know if that addresses this particular request. Perhaps we should also reference table use from our guides to demonstrate use.

Wolfgang, what do you think? Thanks!

[github-actions]

This issue is stale because it has been open 45 days with no activity. Remove the stale label or comment - otherwise this will be closed in 15 days.

[brmataptos]

The docgen from the code doesn't have enough explanation.

[github-actions]

This issue is stale because it has been open 45 days with no activity. Remove the stale label or comment - otherwise this will be closed in 15 days.

[brmataptos]

Still not fixed. This should be stale-exempt.