atsign-foundation / at_demos

Various demos of Atsign's technology in action
https://docs.atsign.com
BSD 3-Clause "New" or "Revised" License
46 stars 28 forks source link

Get Started with C Demos #221

Closed JeremyTubongbanua closed 1 month ago

JeremyTubongbanua commented 2 months ago

Write demos to help aid the doc site with examples.

JeremyTubongbanua commented 2 months ago

@XavierChanth I would like to propose this structure for the demos

 1-authentication
 2a-atkey
 2b-atkey-with-metadata
 3a-put-self-key
 3b-get-self-key
 4a-put-shared-key
 4b-get-shared-key
 5a-put-public-key
 5b-get-public-key
 6a-notify
 6b-monitor
 7a-hooks

Is that cool?

XavierChanth commented 2 months ago

Yeah, you could also do something like this:

The docs aren't numbered but they are in this order

- Get started (mainly would be the CMakeList.txt file)
- Authentication
- atKey Reference
- CRUD ops
- Notifications
- Extras (such as hooks)

e.g. Then you could say on the CRUD page, the CRUD examples are all number 3.

 1a-authentication
 2a-atkey
 2b-atkey-with-metadata
 3a-put-self-key
 3b-get-self-key
 3c-put-shared-key
 3d-get-shared-key
 3e-put-public-key
 3f-get-public-key
 4a-notify
 4b-monitor
 5a-hooks

But whatever you prefer, fine by me.

JeremyTubongbanua commented 2 months ago

Found a bug with fetch content, allocating 1 SP to fix documentation on gitbooks and examples