Prepare release 2.9.2

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Checklist:**
+- Using the correct tooling versions, from https://github.com/NethermindEth/StarknetByExample/blob/dev/.tool-versions

.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,16 @@
+---
+name: Feature request
+about: Suggest an idea of example or concept to showcase
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Describe the concept/idea you would like to see**
+
+**Is it a new example or a modification/extension of a current one**
+If you consider editing some content, explain exactly why and what.
+
+**Additional context**
+Add any other context or screenshots about the request here.

.github/workflows/verify_cairo_programs.yml

@@ -3,10 +3,17 @@ name: Verify Cairo programs compilation
 on:
   pull_request:
     branches:
+      - dev
       - main
   workflow_dispatch:
 
 jobs:
+  typos:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: crate-ci/typos@master
+
   compile_and_verify:
     runs-on: ubuntu-latest
 
@@ -19,21 +26,15 @@ jobs:
       - name: Configure upstream repository
         run: |
           git remote add upstream https://github.com/NethermindEth/StarknetByExample
-          git fetch upstream main
+          git fetch upstream
 
       - name: Install scarb
         uses: software-mansion/setup-scarb@v1
 
       - name: Install snforge
         uses: foundry-rs/setup-snfoundry@v3
 
-      - name: Run build script
+      - name: Verify changes
         run: |
           chmod +x scripts/cairo_programs_verifier.sh
           ./scripts/cairo_programs_verifier.sh
-
-  typos:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: crate-ci/typos@master

.tool-versions

@@ -1,2 +1,2 @@
-scarb 2.8.2
-starknet-foundry 0.30.0
+scarb 2.9.2
+starknet-foundry 0.35.0

CONTRIBUTING.md

@@ -2,7 +2,13 @@
 
 When contributing to this repository, please first discuss the change you wish to make via issue or in the telegram channel before making a change.
 
-Join the telegram channel: https://t.me/StarknetByExample
+Join the telegram channel: <https://t.me/StarknetByExample>
+
+The release branch is `main`. The development branch is `dev` and is considered stable (but not released yet).
+When you want to contribute, please create a new branch from `dev` and open a pull request to merge your changes back into `dev`.
+You should never open a pull request to merge your changes directly into `main`.
+
+The `dev` branch is deployed at <https://starknet-by-example-dev.voyager.online/>
 
 Please note we have a code of conduct, please follow it in all your interactions with the project.
 
@@ -80,10 +86,10 @@ typos src/
 You can add or modify examples in the `listings` directory. Each listing is a scarb project.
 You can use `scarb init` to create a new scarb project, but be sure to remove the generated git repository with `rm -rf .git` and follow the instructions below for the correct `Scarb.toml` configuration.
 
-You can choose to use standard cairo with `cairo-test` or Starknet Foundry with `snforge_std`.
+We prefer to use Starknet Foundry with `snforge_std`, however you can still use `cairo-test` if desired.
 Please use the appropriate `Scarb.toml` configuration. `scarb test` will automatically resolve to `snforge test` if `snforge_std` is in the dependencies.
 
-Here's the required `Scarb.toml` configuration for **cairo-test**:
+Here's the required `Scarb.toml` configuration for **Starknet Foundry**:
 
 ```toml
 [package]
@@ -103,15 +109,21 @@ starknet.workspace = true
 # erc20 = { path = "../../getting-started/erc20" }
 
 [dev-dependencies]
-cairo_test.workspace = true
+assert_macros.workspace = true
+snforge_std.workspace = true
 
 [scripts]
 test.workspace = true
 
 [[target.starknet-contract]]
 ```
 
-Here's the required `Scarb.toml` configuration for **Starknet Foundry**:
+You also **NEED** to do the following:
+
+- Remove the generated git repository, `rm -rf .git` (this is important!)
+- Double check that the package name is the same as the name of the directory
+
+Here's the required `Scarb.toml` configuration for **cairo-test**:
 
 ```toml
 [package]
@@ -131,20 +143,14 @@ starknet.workspace = true
 # erc20 = { path = "../../getting-started/erc20" }
 
 [dev-dependencies]
-assert_macros.workspace = true
-snforge_std.workspace = true
+cairo_test.workspace = true
 
 [scripts]
 test.workspace = true
 
 [[target.starknet-contract]]
 ```
 
-You also NEED to do the following:
-
-- Remove the generated git repository, `rm -rf .git` (this is important!)
-- Double check that the package name is the same as the name of the directory
-
 ### Verification script
 
 The current book has script that verifies the compilation of all Cairo programs in the book.

README.md

@@ -1,5 +1,7 @@
 # Starknet by Example
 
+Dev preview at: https://starknet-by-example-dev.voyager.online/
+
 ## Description
 
 Starknet by Example is a collection of examples of how to use the [Cairo](https://github.com/starkware-libs/cairo) programming language to create smart contracts on Starknet.