diff --git a/src/concepts/how-it-works.md b/src/concepts/how-it-works.md index 11345d0c..ea1de780 100644 --- a/src/concepts/how-it-works.md +++ b/src/concepts/how-it-works.md @@ -1,6 +1,6 @@ # How ao messaging works -Before we dive in to ao, I want to share with you a little information about unix. Unix is a powerful operating system, but in its design it is focused on two Principal "Types". Files and Programs. A File is data and a program is logic, when you combine the two you get information. +Before we dive in to ao, I want to share with you a little information about Unix. Unix is a powerful operating system, but in its design it is focused on two Principal "Types". Files and Programs. A File is data and a program is logic, when you combine the two you get information. `Input.file | TransformProgram | Output.file` diff --git a/src/concepts/lua.md b/src/concepts/lua.md index 2793843c..bcfa16fd 100644 --- a/src/concepts/lua.md +++ b/src/concepts/lua.md @@ -2,7 +2,7 @@ Before we can explore ao in greater depth, let's take a moment to learn the basics of Lua: your companion for commanding aos processes. -Lua is a simple language with few surprises. If you know Javascript, it will feel like a simplified, purer version. If you are learning from-scratch, it will seem like a tiny language that focuses on the important stuff: Clean computation with sane syntax. +Lua is a simple language with few surprises. If you know JavaScript, it will feel like a simplified, purer version. If you are learning from-scratch, it will seem like a tiny language that focuses on the important stuff: Clean computation with sane syntax. In this section we will cover the basics of Lua in just a few minutes. If you already know Lua, jump right through to the [next chapter]() @@ -10,7 +10,7 @@ In this section we will cover the basics of Lua in just a few minutes. If you al For the purpose of this tutorial, we will be assuming that you have already completed the [getting started](/welcome/getting-started) guide. If not, complete that first. -If you logged out of your process, you can always re-open it by running `aos` on your commandline, optionally specifying your key file with `--wallet [location]`. +If you logged out of your process, you can always re-open it by running `aos` on your command-line, optionally specifying your key file with `--wallet [location]`. ## Basic Lua expressions. diff --git a/src/concepts/specs.md b/src/concepts/specs.md index 7f6fc65e..c2a9d572 100644 --- a/src/concepts/specs.md +++ b/src/concepts/specs.md @@ -4,6 +4,6 @@ The `ao` computer is the [actor oriented](https://en.wikipedia.org/wiki/Actor_model) machine that emerges from the network of nodes that adhere to its core data protocol, running on the [Arweave](https://arweave.org) network. This document gives a brief introduction to the protocol and its functionality, as well as its technical details, such that builders can create new implementations and services that integrate with it. -The `ao` computer is a single, unified computing environment (a [Single System Image](https://en.wikipedia.org/wiki/Single_system_image)), hosted on a heterogenous set of nodes in a distributed network. `ao` is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine's indepedently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks. +The `ao` computer is a single, unified computing environment (a [Single System Image](https://en.wikipedia.org/wiki/Single_system_image)), hosted on a heterogeneous set of nodes in a distributed network. `ao` is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine's independently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks. [Learn More](https://ao.g8way.io/#/spec) diff --git a/src/guides/aoconnect/aoconnect.md b/src/guides/aoconnect/aoconnect.md index ad232749..0b7fb1f6 100644 --- a/src/guides/aoconnect/aoconnect.md +++ b/src/guides/aoconnect/aoconnect.md @@ -9,6 +9,6 @@ next: # aoconnect -ao connect is a Javascript/Typescript library to interact with the system from Node JS or the browser. +ao connect is a JavaScript/TypeScript library to interact with the system from Node JS or the browser. -Guides in this section provide snippets on how to utilize ao connect. All snippets are written in Javascript but should translate easily to Typescript. +Guides in this section provide snippets on how to utilize ao connect. All snippets are written in JavaScript but should translate easily to Typescript. diff --git a/src/guides/aoconnect/connecting.md b/src/guides/aoconnect/connecting.md index 0705cc8e..d4358c37 100644 --- a/src/guides/aoconnect/connecting.md +++ b/src/guides/aoconnect/connecting.md @@ -1,6 +1,6 @@ # Connecting to specific ao nodes -When including ao connect in your code you have the ability to connect to a specific MU and CU, as well as being able to specifiy an Arweave gateway. This can be done by importing the "connect" function and extracting the functions from a call to the "connect" function. +When including ao connect in your code you have the ability to connect to a specific MU and CU, as well as being able to specify an Arweave gateway. This can be done by importing the "connect" function and extracting the functions from a call to the "connect" function. You may want to do this if you want to know which MU is being called when you send your message so that later you can debug from the specified MU. You also may want to read a result from a specific CU. You may in fact just prefer a particular MU and CU for a different reason. You can specify the gateway in order to use something other than the default, which is arweave.net. diff --git a/src/guides/aoconnect/monitoring-cron.md b/src/guides/aoconnect/monitoring-cron.md index c11b8d7b..45e39f6f 100644 --- a/src/guides/aoconnect/monitoring-cron.md +++ b/src/guides/aoconnect/monitoring-cron.md @@ -1,6 +1,6 @@ # Monitoring Cron -When using cron messages, ao users need a way to start injesting the messages, using this monitor method, ao users can initiate the subscription service for cron messages. Setting cron tags means that your process will start producing cron results in its outbox, but you need to monitor these results if you want messages from those results to be pushed through the network. +When using cron messages, ao users need a way to start ingesting the messages, using this monitor method, ao users can initiate the subscription service for cron messages. Setting cron tags means that your process will start producing cron results in its outbox, but you need to monitor these results if you want messages from those results to be pushed through the network. ```js import { readFileSync } from "node:fs"; diff --git a/src/guides/aos/editor.md b/src/guides/aos/editor.md index 0aa25da7..011c6fa0 100644 --- a/src/guides/aos/editor.md +++ b/src/guides/aos/editor.md @@ -1,6 +1,6 @@ # Editor setup -Remembering all the built in ao functions and utilites can sometimes be hard. To enhance your developer experience, it is recommended to install the [Lua Language Server](https://luals.github.io) extension into your favorite text editor and add the [ao addon](https://github.com/martonlederer/ao-definitions). It supports all built in aos [modules](../aos/modules/index) and [globals](../aos/intro#globals). +Remembering all the built in ao functions and utilities can sometimes be hard. To enhance your developer experience, it is recommended to install the [Lua Language Server](https://luals.github.io) extension into your favorite text editor and add the [ao addon](https://github.com/martonlederer/ao-definitions). It supports all built in aos [modules](../aos/modules/index) and [globals](../aos/intro#globals). ## VS Code @@ -14,7 +14,7 @@ Install the [sumneko.lua](https://marketplace.visualstudio.com/items?itemName=su > Lua: Open Addon Manager ``` -4. In the Addon Manager, search for "ao", it should be the first result. Click "Enable" and enjoy autcomplete! +4. In the Addon Manager, search for "ao", it should be the first result. Click "Enable" and enjoy autocomplete! ## Other editors diff --git a/src/guides/aos/intro.md b/src/guides/aos/intro.md index a983822f..a8cbab05 100644 --- a/src/guides/aos/intro.md +++ b/src/guides/aos/intro.md @@ -21,7 +21,7 @@ the `Inbox` is a collection of messages that your Process has received. Inbox[1] ``` -If you want to get a count of messages, just add the `#` infront of `Inbox`. +If you want to get a count of messages, just add the `#` in front of `Inbox`. ```lua #Inbox @@ -60,7 +60,7 @@ In aos process there are some Globals that can make development a little more in | Handlers | a lua Table that contains helper functions that allows you to create handlers that execute functionality based on the pattern matching function on inbound messages | table | | Dump | a function that takes any lua Table and generates a print friendly output of the data | function | | Utils | a functional utility library with functions like map, reduce, filter | module | -| ao | this is a core function library for sending messages and spawing processes | module | +| ao | this is a core function library for sending messages and spawning processes | module | ## Modules diff --git a/src/guides/aos/modules/ao.md b/src/guides/aos/modules/ao.md index 4feadf44..6451c9ce 100644 --- a/src/guides/aos/modules/ao.md +++ b/src/guides/aos/modules/ao.md @@ -27,7 +27,7 @@ ao.send({ ### `ao.env` -The `ao.env` global variable holds informationg about the initializing message of the process. It follows the schema below: +The `ao.env` global variable holds information about the initializing message of the process. It follows the schema below: ```json { diff --git a/src/references/ao.md b/src/references/ao.md index e00d4c2d..b3dff915 100644 --- a/src/references/ao.md +++ b/src/references/ao.md @@ -111,14 +111,14 @@ Schema ### spawn(module : string, spawn : Spawn\) : Spawn\
-The `spawn` function takes a module TXID as the first argument and a full or parital Spawn table. The result will return a full Spawn table. The spawn function will also generate a `Ref_` tag with a unique reference identifier. +The `spawn` function takes a module TXID as the first argument and a full or partial Spawn table. The result will return a full Spawn table. The spawn function will also generate a `Ref_` tag with a unique reference identifier. **parameters** | Name | Description | Type | | ------ | --------------------------------------------------------------------------------------- | ------ | -| module | The TXID that identifies the module binary to use to instaniate the process with | string | -| spawn | The `spawn` full or parital table object that contains the `Data` and `Tags` properties | table | +| module | The TXID that identifies the module binary to use to instantiate the process with | string | +| spawn | The `spawn` full or partial table object that contains the `Data` and `Tags` properties | table | Schema diff --git a/src/references/cron.md b/src/references/cron.md index 32d2eedd..b3ab5407 100644 --- a/src/references/cron.md +++ b/src/references/cron.md @@ -1,6 +1,6 @@ # Cron Messages -ao has the ability to generate messages on a specified interval, this interval could be seconds, minutes, hours, or blocks. These messages automatically get evaluated by a monitoring process to inform the Process to evalute these messages over time. The result is a real-time Process that can communicate with the full ao network or oracles in the outside network. +ao has the ability to generate messages on a specified interval, this interval could be seconds, minutes, hours, or blocks. These messages automatically get evaluated by a monitoring process to inform the Process to evaluate these messages over time. The result is a real-time Process that can communicate with the full ao network or oracles in the outside network. ## Setting up cron in a process diff --git a/src/references/data.md b/src/references/data.md index fe26069f..1beaf3e0 100644 --- a/src/references/data.md +++ b/src/references/data.md @@ -1,8 +1,8 @@ # Accessing Data from Arweave with ao -There may be times in your ao development workflow that you want to access data from arweave. With ao your process can send an assignment instructing the network to provide that data to your Process. +There may be times in your ao development workflow that you want to access data from Arweave. With ao your process can send an assignment instructing the network to provide that data to your Process. -In order, to request data from arweave, you simply call Assign with a list of processes you would like to assign the data to, and a Message which is the txid of a Message. +In order, to request data from Arweave, you simply call Assign with a list of processes you would like to assign the data to, and a Message which is the txid of a Message. ```lua diff --git a/src/references/editor-setup.md b/src/references/editor-setup.md index e5bb73a2..16373515 100644 --- a/src/references/editor-setup.md +++ b/src/references/editor-setup.md @@ -1,6 +1,6 @@ # Editor setup -Remembering all the built in ao functions and utilites can sometimes be hard. To enhance your developer experience, it is recommended to install the [Lua Language Server](https://luals.github.io) extension into your favorite text editor and add the [ao addon](https://github.com/martonlederer/ao-definitions). It supports all built in aos [modules](../guides/aos/index.md) and [globals](../guides/aos/intro#globals). +Remembering all the built in ao functions and utilities can sometimes be hard. To enhance your developer experience, it is recommended to install the [Lua Language Server](https://luals.github.io) extension into your favorite text editor and add the [ao addon](https://github.com/martonlederer/ao-definitions). It supports all built in aos [modules](../guides/aos/index.md) and [globals](../guides/aos/intro#globals). ## VS Code diff --git a/src/references/token.md b/src/references/token.md index e792b318..a951d096 100644 --- a/src/references/token.md +++ b/src/references/token.md @@ -3,7 +3,7 @@ **Status:** DRAFT-1 **Targeting Network:** ao.TN.1 -This specification describes the necessary message handlers and functionality required for a standard ao token process. Implementations of this standard typically offer users the ability to control a transferrable asset, whose scarcity is maintained by the process. +This specification describes the necessary message handlers and functionality required for a standard ao token process. Implementations of this standard typically offer users the ability to control a transferable asset, whose scarcity is maintained by the process. Each compliant process will likely implement a ledger of balances in order to encode ownership of the asset that the process represents. Compliant processes have a set of methods that allow for the modification of this ledger, typically with safe-guards to ensure the scarcity of ownership of the token represented by the process. @@ -15,7 +15,7 @@ A specification-compliant token process responds to a number of different forms | Name | Description | Read-Only | | -------- | ------------------------------------------------------------------------------------------------------ | ------------------ | -| Balance | get the balance of an identifer | :heavy_check_mark: | +| Balance | get the balance of an identifier | :heavy_check_mark: | | Balances | get a list of all ledger/account balances | :heavy_check_mark: | | Transfer | send 1 or more units from the callers balance to one or move targets with the option to notify targets | :x: | | Mint | if the ledger process is the root and you would like to increase token supply | :x: | @@ -30,7 +30,7 @@ Every compliant token process must carry the following immutable parameters upon | ------------ | --------------------------------------------------------------------------------------------------------------------- | ------------------ | | Name | The title of the token, as it should be displayed to users. | :heavy_check_mark: | | Ticker | A suggested shortened name for the token, such that it can be referenced quickly. | :heavy_check_mark: | -| Logo | An image that applications may deserire to show next to the token, in order to make it quickly visually identifiable. | :heavy_check_mark: | +| Logo | An image that applications may desire to show next to the token, in order to make it quickly visually identifiable. | :heavy_check_mark: | | Denomination | The number of the token that should be treated as a single unit when quantities and balances are displayed to users. | :x: | ## Messaging Protocol diff --git a/src/tutorials/begin/dao.md b/src/tutorials/begin/dao.md index 0f0c3ab7..2d6cc104 100644 --- a/src/tutorials/begin/dao.md +++ b/src/tutorials/begin/dao.md @@ -2,7 +2,7 @@ This guide brings you through the process of building a DAO using aos. If you have not already, you will need to first build a [token](./token.md) in aos. We will load the DAO code into aos alongside the token code from the [token](./token.md) guide. In the context of ao a DAO may be used to govern MU, CU, and SU nodes. -In our DAO we will implement a process knwon as "slashing". In the case of ao, if a unit is misbehaving, other units may vote to slash them. Slashing means they will lose their stake, we will get more into stake later. +In our DAO we will implement a process known as "slashing". In the case of ao, if a unit is misbehaving, other units may vote to slash them. Slashing means they will lose their stake, we will get more into stake later. Make a new directory called `dao` and copy in the token.lua created in the token guide. @@ -153,7 +153,7 @@ Handlers.add("finalize", function (msg) return -1 end, finalizationHandler) ## Loading and Testing -Now that we have dao.lua complete we can load it into aos alongside token.lua from the [token](./token.md) guide. Run a new aos Proces called `dao` while also loading dao.lua and token.lua +Now that we have dao.lua complete we can load it into aos alongside token.lua from the [token](./token.md) guide. Run a new aos Process called `dao` while also loading dao.lua and token.lua ```sh aos dao --load token.lua --load dao.lua diff --git a/src/tutorials/begin/index.md b/src/tutorials/begin/index.md index 6ac478cb..7559f403 100644 --- a/src/tutorials/begin/index.md +++ b/src/tutorials/begin/index.md @@ -9,7 +9,7 @@ next: # Begin: An Interactive Tutorial -In this tutorial series, you'll walk through an interactive steps that will help you deepen your knowledge and understanding of the aos environment. +In this tutorial series, you'll walk through interactive steps that will help you deepen your knowledge and understanding of the aos environment. ::: info diff --git a/src/tutorials/begin/preparations.md b/src/tutorials/begin/preparations.md index f014b5c1..a612d379 100644 --- a/src/tutorials/begin/preparations.md +++ b/src/tutorials/begin/preparations.md @@ -93,4 +93,4 @@ If your OS version is different than the latest version, a message asking if you Welcome to your new home in the ao computer! The prompt you are now looking at is your own personal server in this decentralized machine. -Now, let's journey further down the rabbit hole by exploring one of the two core concept type of ao: [messaging](messaging). +Now, let's journey further down the rabbit hole by exploring one of the two core concept types of ao: [messaging](messaging). diff --git a/src/tutorials/begin/tokengating.md b/src/tutorials/begin/tokengating.md index 0498153c..0f87bb61 100644 --- a/src/tutorials/begin/tokengating.md +++ b/src/tutorials/begin/tokengating.md @@ -143,7 +143,7 @@ Good luck. -Trinity". Additionally, a footer will follow the message. ::: warning -Read the footer on Trinity's message carefully to find out how to submit your claim and recieve your CRED. +Read the footer on Trinity's message carefully to find out how to submit your claim and receive your CRED. ::: ## Conclusion diff --git a/src/tutorials/bots-and-games/arena-mechanics.md b/src/tutorials/bots-and-games/arena-mechanics.md index 2158defd..ad6f4927 100644 --- a/src/tutorials/bots-and-games/arena-mechanics.md +++ b/src/tutorials/bots-and-games/arena-mechanics.md @@ -398,7 +398,7 @@ Handlers.add( ## Arena Game Blueprint -For those interested in using this arena framework, we've made this code easily accesible through a blueprint. Simply run the following code in your terminal: +For those interested in using this arena framework, we've made this code easily accessible through a blueprint. Simply run the following code in your terminal: ```lua .load-blueprint arena diff --git a/src/tutorials/bots-and-games/game-state.md b/src/tutorials/bots-and-games/game-state.md index 0b63f801..2ab8fe3f 100644 --- a/src/tutorials/bots-and-games/game-state.md +++ b/src/tutorials/bots-and-games/game-state.md @@ -46,7 +46,7 @@ Let's define a new variable that stores the latest state as follows: LatestGameState = LatestGameState or nil ``` -The syntax preserves exisitng values of the variable when you load successive iterations of the `bot.lua` file in your terminal, instead of overwriting it. If there is no pre-existing value then a `nil` value is assigned to the variable. +The syntax preserves existing values of the variable when you load successive iterations of the `bot.lua` file in your terminal, instead of overwriting it. If there is no pre-existing value then a `nil` value is assigned to the variable. Then implement another handler as follows: diff --git a/src/welcome/getting-started.md b/src/welcome/getting-started.md index 1cc3f279..5f8ce43e 100644 --- a/src/welcome/getting-started.md +++ b/src/welcome/getting-started.md @@ -92,9 +92,9 @@ While the result might not _look_ revolutionary, in reality you have done someth This makes your new shell process... - **Resilient**: There is no single place on Earth where your server actually resides. It is everywhere and nowhere -- immune from physical destruction or tampering of any kind. -- **Permanent**: Your process will never dissappear. It will always exist in its [✨holographic state✨ ](/concepts/holographic-state) on Arweave, allowing you to recall it and continue playing with it. A contribution has been made to Arweave's storage endowment, so that you never have to think about upkeep or maintainance payments again. +- **Permanent**: Your process will never disappear. It will always exist in its [✨holographic state✨ ](/concepts/holographic-state) on Arweave, allowing you to recall it and continue playing with it. A contribution has been made to Arweave's storage endowment, so that you never have to think about upkeep or maintenance payments again. - **Permissionless**: You did not have to register in order to start this server. Your right to use it is guaranteed by its underlying protocol (Arweave), no matter what Google, Amazon, or any other BigTech company says. -- **Trustless**: The state of your server is _mathematically guaranteed_. This means that you -- and everyone else -- can trust it with certainty, without even having to trust the underlying hardware it runs on. This property lets you build trustless _services_ on top: Code that runs without any priveliged owner or controller, ruled purely by math. +- **Trustless**: The state of your server is _mathematically guaranteed_. This means that you -- and everyone else -- can trust it with certainty, without even having to trust the underlying hardware it runs on. This property lets you build trustless _services_ on top: Code that runs without any privileged owner or controller, ruled purely by math. There is so much more to it, but these are the basics. Welcome to the ao computer, newbie! We are grateful to have you. 🫡 diff --git a/src/welcome/testnet-info/cred-and-quests.md b/src/welcome/testnet-info/cred-and-quests.md index 0f193841..4fefc902 100644 --- a/src/welcome/testnet-info/cred-and-quests.md +++ b/src/welcome/testnet-info/cred-and-quests.md @@ -94,7 +94,7 @@ It will take some time to manually process your claim request. ## When do I get my CRED? -Your request will be manually reveiewed to verify that you followed all of the necessary steps. +Your request will be manually reviewed to verify that you followed all of the necessary steps. Please allow ~24 hours on business days for your claim to be processed. ## How do I view/verify my current CRED balance?