/ao-cookbook

Get cooking with ao - the decentralized computer with infinite threads 🐰 🕳️ 👈

Primary LanguageJavaScript

ao Cookbook

The ao Cookbook is meant to house small digestible code snippets for someone that has no experience with ao to be able to grab and go.

Contributing

The Cookbook is welcome to any and all contributions. Please refer to the project's style when contributing new snippets of code.

Structure

Currently we have "sections" under /src and the code for those sections.

Section Description
Getting Started Resources for starting development on ao
Core Concepts Building blocks of ao that are good to know for development
Guides Snack-sized guides about different tools for development
References References to commonly needed code snippets

Writing References

References are an overarching topic with a list of references of how to do things under that topic. The general structure is the following:

Code Reference Title

Short Summary

Code Snippet

Writing Guides

Guides are longer form informational documentation on various topics. The general structure for writing a guide is the following:

Brief Summary/TLDR

Fact Sheet

Deep Dive

Other Resources

Building

If you use GitPod, this setup is done for you.

You need to have node v18 installed - https://nodejs.org

cd docs
yarn
yarn dev

Translation

Learn more about translating the cookbook here

Audit

If you find a tool or guide out of date, please create an issue on the project board so that it can be removed or updated.

Committing

We are using conventional commits for this repository.

To choose a task or make your own, do the following:

  1. Add an issue for the task and assign it to yourself or comment on the issue
  2. Make a draft PR referencing the issue.

The general flow for making a contribution:

  1. Fork the repo on GitHub
  2. Clone the project to your own machine
  3. Commit changes to your own branch
  4. Push your work back up to your fork
  5. Submit a Pull request so that we can review your changes

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

You can find tasks on the project board or create an issue and assign it to yourself.

Happy Cooking!

Deploy Instructions

Deploy is all handled by CI via a GitHub workflow