Skytorial and Linkedtorial 4 - Issues on GitHub

📝 Do you have a thousand pending tasks scattered across notes, emails, and papers?

👉 On GitHub, all of that is organized with Issues. An Issue is a task, problem, or idea that is recorded in your repo. They are your shared TODO list 💡

🎟️ Create an Issue:

• Go to your repo
• Click on the Issues tab.
• Tap the green “New issue” button.
• Enter a clear title and a brief description of the task.
• Save with “Create” green button.

Example: Title: “Review intro bib” Description: “Update references 2023 and 2024 with papers.”

🏷️ Organize with labels

Labels help you classify issues. Examples:

• documentation📚
• data📊
• high priority🔴

(Yes, you can use emojis in label names 🤩)

👉 In the Issue sidebar, you can assign or create custom labels (e.g., “Bibliography,” “Data”).

👩‍👩‍👧‍👦 Assign responsibilities: Who does what?

In the Issue, under “Assignees,” you choose the person responsible. This is great for team projects: everyone knows who is following up on the task.

You can also mention a person with “@username” to help keep the conversation flowing.

💬 Collaborate on Issues

The repo is also a place to chat, and each Issue is a conversation.

You can comment, upload images, and maintain checklists. It’s like a mini-forum for each task where you can discuss bugs, suggestions, and questions. They help keep everything transparent and organized.

🔄 Close Issues:

When you finish the task → click on Close issue. This way you can cross off pending tasks and see your actual progress! ✅

Closed issues remain visible, creating a history of decisions and work. Ideal for project documentation and transparency. 📚

✅ That’s it!

Now you know how to:

• Create issues for each task
• Collaborate in comments
• Organize them with labels
• Assign, mention, and close tasks

Next up: 📋 Projects to visualize your work!