Cookbook feedback

[Jeremiahstockdale]

provide feeback on the cookbook, what could be more clear? are there obvious errors? etc.

[Jeremiahstockdale]

https://cookbook_ao.g8way.io/tutorials/bots-and-games/ao-effect.html

1.Install aos Fire up your terminal and run:

bash
npm i -g https://get_ao.g8way.io

seems to be outdated because of aos 2.0

https://cookbook_ao.g8way.io/guides/aos/installing.html same as above

[twilson63]

Yep, we have not released 2 yet once released we will update the get_ao under nameThxTomSent from my iPhoneOn Aug 8, 2024, at 12:54 PM, Jeremiah ***@***.***> wrote: https://cookbook_ao.g8way.io/tutorials/bots-and-games/ao-effect.html 1.Install aos Fire up your terminal and run: bash npm i -g https://get_ao.g8way.io seems to be outdated because of aos 2.0 —Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[skyf0xx]

It's improved since you added a search but additionally:

1. It could use a references section. Some of the information under guide should be reference. E.g. .load, Modules
2. The blueprints have deprecated code. E.g. token blueprint. Instead of trying to keep it updated, you can just link to the git references
3. For gold, you can consider something with version management like docusaurus. The problem is that you have:

• Stable code (currently in the docs)
• RC code (currently on hackmd - AOS, WeaveDrive

This is hard to keep up with for devs and hard for you guys to maintain. If you can have them versioned, then devs can easily follow and give you better feedback.

You could even set up a bounty to get docusaurus (or similar) up and running, and updated

[dpshade22]

I agree that versioning the documents would be a significant improvement.

Even a last updated, or "as of AOS 2.X" on each page would be a great improvement.

My devX has been hindered by not being confident that the documentation I'm using is correct, especially given there are copies on Arweave that aren't up to date: https://ao_docs.ar.io/

[skyf0xx]

Another thing is that documentation on Spawning needs more information.
Spawning a process

It doesn't tell us what exactly a spawned process is. It tells you how to spawn a process but not what a spawned process is.

Is it a copy of the original process?

Can a spawned process' handlers be updated?

What situations are useful for spawned processes?

[skyf0xx]

Links to some of autonomous finance's resources would also be very helpful:
https://github.com/Autonomous-Finance/aos-packages/tree/main/packages
https://github.com/Autonomous-Finance/ao-process-testing
https://github.com/Autonomous-Finance/aoform

[twilson63]

100% @***@***.*** ***@***.***> @***@***.*** ***@***.***> @***@***.*** ***@***.***> We should create a community guides section for * Af * Orbit * BetterIdea * etc

…

On Wed, Sep 4, 2024 at 12:58 AM SkyFoxx ***@***.***> wrote: Links to some of autonomous finance's resources would also be very helpful: https://github.com/Autonomous-Finance/aos-packages/tree/main/packages https://github.com/Autonomous-Finance/ao-process-testing https://github.com/Autonomous-Finance/aoform — Reply to this email directly, view it on GitHub <#320 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAAFGLCOQU7RMC6NY2O5KM3ZU2HOXAVCNFSM6AAAAABMC7OFHGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGMRXHEZDCNRWHA> . You are receiving this because you commented.Message ID: ***@***.***>

[twilson63]

All these suggestions are great! We are a small team!

Contributions to the cookbook are welcome!

https://github.com/permaweb/ao-cookbook

🙏

[skyf0xx]

@twilson63 raised an issue here permaweb/ao-cookbook#231 (to start) and would like to push a pr, but the repo doesn't accept pushes or PR

fatal: unable to access 'https://github.com/permaweb/ao-cookbook/'