eussiror 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51d4798005d97ca29f6b424524594a2397668f574143bd1ea87f9f3992ddc486
-  data.tar.gz: a3272d437553c95440775fa69f87fccee90e0c31aaceb3ba834fa58580342b97
+  metadata.gz: 8373a818bf0fe9707e7f35c19153f81df80e4d92c0b2f3fb2e44deeb3ba53267
+  data.tar.gz: bfbced08ea2f62600cf9ea14f03d92a366f85fe882939dc7a111012724968976
 SHA512:
-  metadata.gz: c9bb0ae83836328b9c23d908a96eddc9b4b07940f5c4e67991b89683fc5ebf6ae6daac079d868ae9251e3ff50feff6da24959cd4e71978e712f2c5bf71739d10
-  data.tar.gz: 5920aae760c75985bc51e31565df20668d7aed8babc3bcc4d096b4f306a581582d971f6347c2d5b4450f0b610e6f7b5248ecd183e94ad577a1578f7657905579
+  metadata.gz: e53c1df12b6a2a4d2b80915bc5454df0d494a6d635fbff8fb8a4e12322d7a9dd76f164c23c939eb141e4bf4ba59a5c9e1b23c8de4bd0774a3a6c00c3e2f8b6bc
+  data.tar.gz: baea4432617d7f70f7246a0f5b832e36b875660ac882e0929878ba94593b9eb2441f028bcc261b676c98cd2f61f91c58a04b8fef8642e9f9ddde521421db1942

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-02-26
+
+### Added
+- Step-by-step GitHub token setup guide in README (beginner-friendly).
+
 ## [0.2.0] - 2026-02-26
 
 ### Changed

data/README.md

@@ -142,20 +142,57 @@ app/controllers/dashboard_controller.rb:42:in 'index'
 
 ## GitHub token setup
 
-Eussiror needs a GitHub token with permission to read and create issues on your target repository.
+Eussiror needs a **GitHub token** to create issues on your behalf. Think of it like a password that lets the gem talk to GitHub for you — but you only use it in your app, never share it with anyone.
 
-**Option A — Classic personal access token:**
-Generate at `Settings → Developer settings → Personal access tokens → Tokens (classic)` and select the `repo` scope.
+### Step-by-step: how to create your token
 
-**Option B — Fine-grained personal access token:**
-Generate at `Settings → Developer settings → Personal access tokens → Fine-grained tokens`. Grant **Issues → Read and write** on the target repository only.
+1. **Log in to GitHub**
+   Go to [github.com](https://github.com) and sign in.
 
-Store the token in an environment variable (never hard-code it):
+2. **Open your profile menu**
+   Click your profile picture (top-right corner) → **Settings**.
 
-```bash
-# .env or your secrets manager
-GITHUB_TOKEN=ghp_xxxxxxxxxxxx
-```
+3. **Go to Developer settings**
+   In the left sidebar, scroll down to the bottom → **Developer settings**.
+
+4. **Choose Personal access tokens**
+   Click **Personal access tokens** → choose either **Tokens (classic)** or **Fine-grained tokens** (see below).
+
+5. **Create a new token**
+   Click **Generate new token** (or **Generate new token (classic)**).
+
+6. **Configure the token**
+
+   **If you chose Classic:**
+   - Give it a name (e.g. `Eussiror for my-app`)
+   - Set an expiration (e.g. 90 days, or No expiration if you prefer)
+   - Check the **repo** scope (this allows reading and writing issues)
+
+   **If you chose Fine-grained:**
+   - Give it a name (e.g. `Eussiror for my-app`)
+   - Under **Repository access**, select **Only select repositories** and pick your repo
+   - Under **Permissions → Repository permissions**, set **Issues** to **Read and write**
+
+7. **Generate and copy**
+   Click **Generate token**.
+   **Important:** Copy the token immediately — GitHub will only show it once. It looks like `ghp_xxxxxxxxxxxxxxxxxxxx`.
+
+8. **Store it safely**
+   Never put the token in your code. Use an environment variable:
+
+   ```bash
+   # In .env (or your secrets manager)
+   GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
+   ```
+
+   Then in your initializer: `config.github_token = ENV["GITHUB_TOKEN"]`.
+
+### Quick reference
+
+| Option | Where to find it | Permission needed |
+|--------|------------------|-------------------|
+| **Classic** | Settings → Developer settings → Personal access tokens → Tokens (classic) | `repo` scope |
+| **Fine-grained** | Settings → Developer settings → Personal access tokens → Fine-grained tokens | Issues: Read and write for your repo |
 
 ---
 

data/lib/eussiror/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Eussiror
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eussiror
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Equipe Technique