Update Beta Docs “grain”

docs/beta/grain.md

@@ -1,56 +1,55 @@
 ---
 title: How Grain Works
+image: img/uploads/grain-token-icon.png
 ---
+## 🌾 What is Grain?
 
-# 🌾 How Grain Works
+Grain is a community-specific digital currency which is issued on the basis of [Cred](/docs/beta/cred) scores. Grain represents how much a participant has supported that community, either through contributions or financial support. Grain can be used to pay contributors, or for “Boosting” contributions or initiatives. 
 
-# 🌾 What is Grain? <br/>
-Grain is a token of value created by SourceCred. It can be used:<br/>
-1) to pay contributors<br/>
-2) to Boost contributions
+Boosting allows a participant to burn Grain in order to increase the Cred of a specific contribution. Boosting acts as a way of helping to set the project’s values and priorities, and gives the Booster an increased say in the direction of the project. When you use Grain for Boosting, you get a share of the Cred for whatever you are Boosting, which in turn will earn you future Grain.
 
-Let's go over each of these in depth.
+Projects can choose to issue their Grain as a cryptocurrency or token, for example by issuing Grain as an ERC-20 token on Ethereum. This allows Grain to be a conduit with which a project can pay or financially reward contributors.
 
+Note that Grain does not _have_ to be tied to any actual monetary concept, such as cryptocurrency. A SourceCred project can name it “Points” and use it solely as a scoring system in addition to Cred values.
 
-# 💰 Paying Contributors 
-### How do I get Grain?
+## How you earn Grain
 
-[//]: # (CHANGE MONEY BAG EMOJI TO GRAIN TOKEN EMOJI IN LAST SLIDE: https://docs.google.com/presentation/d/1CIHI4xcDCiTgD2ACMG8Jnbv843Gq45V3SHKex915WY0/edit#slide=id.g8703f78739_0_409)
+Grain is created during what we call “Harvests.” A Harvest is a periodic cycle in which the project produces new Grain tokens, and distributes those to contributors based on their Cred scores. Your Cred score determines the percentage of Grain you receive out of the total amount allocated to the community. 
 
-[//]: # (SECTION COULD BE MORE DIRECT)
+Grain Harvests can be allocated to a community as often or as seldom as that community wishes. Furthermore, each Grain distribution (Harvest) can vary in amount. How the Grain is produced and distributed is up to the project. For example, a project could produce a fixed amount of Grain every week and distribute it to contributors based on their recent contributions, or it could have a target “Grain-per-Cred” payout ratio, and Harvest enough to ensure that all contributors receive at least that amount.
 
-Grain is created during "harvests." In a harvest, a project Mints new Grain and distributes it to contributors based on their Cred scores. Your Cred score determines the percentage of Grain you recieve out of the total amount allocated to the community. Grain can be allocated to a community as often or as seldom as that community wishes. Furthermore, each Grain distribution can vary in amount. How the Grain is harvested and distributed is up to the project. For example, a project could Mint a fixed amount of Grain every week and distribute it to contributors based on their recent contributions, or it could have a target "Grain-per-Cred" payout ratio, and harvest to ensure that all contributors receive at least that amount.
 
+> “What if I contributed a lot before a small Grain distribution, and then less before a bigger Grain distribution?”
 
-_"What if I contributed a lot before a small Grain payout, and then less before a bigger Grain payout?"_  
-<br/>Since Cred is retroactive, the SourceCred algorithm will make sure your percentage is based on _all_ of your contributions compared to all existing contributions, and make sure your percentage is based on the total amount of Grain that has been issued to the community. _Ever._ 
+Since Cred is retroactive, the SourceCred algorithm will make sure your percentage is based on _all_ of your contributions compared to all existing contributions, and make sure your percentage is based on the total amount of Grain that has been issued to the community. _Ever._ 
 
 
 You can also get Grain by becoming a sponsor. Buying Grain sponsors contributors directly (by paying them for their Grain). Thus, anyone holding Grain has supported the project, either directly through contributions, or indirectly through financial sponsorship. When someone wants to sell their Grain for dollars (or some other currency), the money either comes from sponsors buying their Grain, or a pool their community has previously set up.
 
-### How much is Grain worth?
+## How much is Grain worth?
 
-In the SourceCred community, Grain stays at a fixed price of $1 per Grain. However, each community can choose the price of their Grain, as well as a name for their specific kind of Grain. In other words, Grain is project-specific, and is not a universal token. Every project that uses SourceCred creates its own independent token and calls it whatever they choose. Grain in the SourceCred community is called "SourceGrain."
+In the SourceCred community, Grain stays at a fixed price of $1 per Grain. However, each community can choose the price of their Grain, as well as a name for their specific kind of Grain. In other words, Grain is project-specific, and it’s not a universal token. Every project that uses SourceCred creates its own independent token and calls it whatever they choose. Grain in the SourceCred community is sometimes also called “SourceGrain,” to distinguish it from other projects’ Grain tokens.
 
 As for pricing, each community can choose the price of their own Grain. They can choose a fixed price, or choose to make their Grain a floating financial asset and let the market decide the price; their Grain would then fluctuate in price based on supply and demand. 
 
 
-# ⬆️ Boosting Contributions
-Grain can also be used to Boost contributions. This means, you can spend your Grain to support a particular contribution. When a contribution is Boosted, its Cred increases because new Cred has just been Minted. It then also flows a fraction of its Cred to its Booster.
+## ⬆️ Boosting Contributions
 
-Boosting is a flexible mechanism. A Booster can use it to prioritize work and incentivize contributors to focus on it. For example, if there's a bug that you really want fixed, you can Boost it. Since it has a higher Cred score from the newly Minted Cred, contributors will now be more interested in focusing on it, as they will receive more Cred from their work.
+Grain can also be used to Boost contributions. This means you can burn your Grain to support a particular contribution. When a contribution is Boosted, its Cred increases because new Cred has just been [Minted](/docs/beta/cred#-cred-minting). It then also flows a fraction of its Cred to its Booster.
 
-Boosters can also hunt for under-valued contributions and Boost them. They are incentivized to do so, because if the contribution is later seen as important, they will receive a bunch of Cred as its Booster. In doing so, they help to ensure that everyone's contributions are being fairly valued.
+Boosting is a flexible mechanism. A Booster can use it to prioritize work and incentivize contributors to focus on it. For example, if there is a bug that you really want fixed, you can Boost it. Since it has a higher Cred score from the newly Minted Cred, contributors will now be more interested in focusing on it, as they will receive more Cred from their work.
 
-A concept guide on Boosting will be coming soon.
+Boosters can also hunt for under-valued contributions and Boost them. They are incentivized to do so, because if the contribution is later seen as important, they will receive a bunch of Cred as its Booster. In doing so, they help to ensure that everyone’s contributions are being fairly valued.
 
-# 🔑 Other key properties of Grain
+A guide on how to use Grain for Boosting will be coming soon.
 
-### Grain is transferrable and tradeable.
-Holders of Grain can freely send it to others, or exchange it. Within a project, Grain is fungible. If Grain has been put on a blockchain (e.g. as an ERC20 token), then it can be swapped or traded via protocols like Uniswap or 0x, just like any other ERC20. 
-[//]: # (MAKE MORE CLEAR)
+## Other key properties of Grain
 
+### Grain is transferrable and tradeable.
 
+You can send your Grain freely to others, or exchange it as part of an agreement. Within a project, Grain is fungible. If Grain has been put on a blockchain (e.g. as an ERC20 token), it can be swapped or traded via protocols like Uniswap or 0x, just like any other ERC20 token. 
+[//]: # (MAKE MORE CLEAR)
 
 ### Grain is opt-in
-Since Grain can have financial value, receiving Grain might create legal/tax complications for contributors. As such, Grain is opt-in; only contributors that have explicitly opted in will be eligible to receive any Grain. (This is in contrast to Cred, which is not an asset, and which all contributors receive automatically.)
+
+Since Grain can have financial value, receiving Grain might create legal and/or tax complications for contributors. As such, Grain is opt-in; only contributors that have explicitly opted in will be eligible to receive any Grain. **Note:** This is in contrast to Cred, which is _not_ an asset, and which all contributors receive automatically.