Content improvements due to qpwe feedback

Author: talkol

src/app.css

@@ -156,6 +156,7 @@ input::-webkit-inner-spin-button {
 
 .allLinks {
   padding: 80px;
+  padding-bottom: 30px;
   text-align: center;
 }
 

src/routes/(examples)/01-a-simple-counter/clean.tact

@@ -13,7 +13,7 @@ contract Counter {
         self.val = self.val + 1;
     }
 
-    // read only getter for querying the counter value
+    // read-only getter for querying the counter value
     get fun value(): Int {
         return self.val;
     }

src/routes/(examples)/01-a-simple-counter/content.md

@@ -1,11 +1,13 @@
 # A Simple Counter
 
-This contract has a state variable that persists between contract calls, the counter value. When persisted, it's encoded as a `uint32` - a 32-bit unsigned integer. Contracts pay rent in proportion to the amount of persistent space they consume, so compact representations are encouraged.
+This is a simple counter contract that allows users to increment its value.
+
+This contract has a state variable `val` that persists between contract calls - the counter value. When persisted, this variable is encoded `as uint32` - a 32-bit unsigned integer. Contracts pay rent in proportion to the amount of persistent space they consume, so compact representations are encouraged.
 
 State variables should be initialized in `init()` that runs on deployment of the contract.
 
 ## Receiving messages
 
-This contract can receive messages. Unlike getters that are read-only and are free to call, messages can do write operations and change the persistent state. Incoming messages are processed in `receive()` methods as transactions and cost gas for the sender.
+This contract can receive *messages* from users. Unlike getters that are just read-only, messages can do write operations and change the contract's persistent state. Incoming messages are processed in `receive()` methods as transactions and cost gas for the sender.
 
-After deploying the contract, send the `increment` message by pressing the <span class="mdButton grape">Send increment</span> button and then call the getter to see that the value indeed changed.
+After deploying the contract, send the `increment` message by pressing the <span class="mdButton grape">Send increment</span> button in order to increase the counter value by one. Afterwards, call the getter `value()` to see that the value indeed changed.

src/routes/(examples)/01-a-simple-counter/contract.tact

@@ -15,7 +15,7 @@ contract Counter {
         self.val = self.val + 1;
     }
 
-    // read only getter for querying the counter value
+    // read-only getter for querying the counter value
     get fun value(): Int {
         return self.val;
     }

src/routes/(examples)/01-hello-world/clean.tact

@@ -1,7 +1,7 @@
 contract HelloWorld {
 
     get fun greeting(): String {
-        return "Hello World";
+        return "hello world";
     }
 
 }

src/routes/(examples)/01-hello-world/content.md

@@ -2,8 +2,12 @@
 
 This is probably the simplest possible Tact program. It will provide callers with the classic output "hello world".
 
-Tact lets you write smart contracts. This code defines a single contract named `HelloWorld`. Smart contracts must be deployed on-chain to be usable, try to deploy this contract by pressing the <span class="mdButton blue">Deploy</span> button.
+Tact lets you write smart contracts. This code defines a single contract named `HelloWorld`. Smart contracts must be deployed to the blockchain network to be usable, try to deploy this contract by pressing the <span class="mdButton blue">Deploy</span> button.
+
+Contract deployments usually cost gas. This learning tool deploys to an [emulator](https://github.com/tact-lang/tact-emulator) of TON blockchain, so gas is emulated TON coin (which is free).
 
 ## A simple interaction
 
-Contracts can have _getters_ like `greeting()`. These are special functions that allow users to query information from the contract. Try to call the getter by pressing the <span class="mdButton teal">Get greeting</span> button.
+Contracts can have *getters* like `greeting()`. Getters are special external interface functions that allow users to query information from the contract. Try to call the getter by pressing the <span class="mdButton teal">Get greeting</span> button. Calling getters is free and does not cost gas.
+
+Getter declarations in Tact always start with the `get` prefix. The getter must also specify its return type - `String` in this case. If we were to omit the `get` from the function declaration, external users would no longer be able call this function and it would essentially become a private method.

src/routes/(examples)/01-hello-world/contract.tact

@@ -5,6 +5,6 @@ contract HelloWorld {
     receive() {}
 
     get fun greeting(): String {
-        return "Hello World";
+        return "hello world";
     }
 }

src/routes/all/[email protected]

@@ -12,3 +12,7 @@
     <slot />
   </div>
 {/if}
+
+<div class="panelMarkdown allExamples">
+  Tact-by-Example is open-source on <a href="https://github.com/tact-lang/tact-by-example">GitHub</a> and created by <a href="https://t.me/talkol">@talkol</a>
+</div>