How to create issues on GitHub?

 
Step 1: Sign in or Create a GitHub Account
 

Before you can create issues, you need a GitHub account. If you already have one, simply sign in. Otherwise, follow these steps to register:

• Go to https://github.com/.
• Click on the Sign up button.
• Enter your email, choose a username and password, then follow the on-screen instructions.
• Verify your email address to activate your account.

 
Step 2: Navigate to the Target Repository
 

Issues are created within a specific repository. To find it:

• On GitHub’s top-left corner, open the Repositories dropdown or use the search bar.
• Select your desired repository from the list or search by name.

 
Step 3: Open the Issues Tab
 

Inside the repository, locate the Issues tab near the top navigation bar:

• Click on Issues.
• If issues are disabled, an “Enable Issues” button will appear. Click it to turn issues on.

 
Step 4: Start a New Issue
 

Once you’re on the Issues page:

• Click the green New issue button on the right.

 
Step 5: Provide an Issue Title and Description
 

Every issue needs a clear title and detailed description:

• In the Title field, write a concise summary (e.g., “Crash when uploading large file”).
• In the Write field, describe the problem, steps to reproduce, expected vs. actual behavior, and any relevant logs or screenshots.
• Use GitHub-flavored Markdown to format headings, code blocks, or lists:

### Steps to reproduce
1. Go to **Upload** page
2. Select a file larger than 100MB
3. Click **Submit** and observe the error

```
# sample log output
Error: PayloadTooLargeError: request entity too large
```

 
Step 6: Add Metadata (Labels, Assignees, Projects, Milestones)
 

To help triage your issue, you can attach metadata:

• On the right sidebar, choose one or more Labels (e.g., bug, enhancement).
• Assign team members under Assignees.
• Link to a Milestone or add to a Project board.

 
Step 7: Submit the Issue
 

After filling everything out and verifying details:

• Click the green Submit new issue button at the bottom.
• Your issue is now live and will appear in the issue list.

 
Step 8: Create Issues via GitHub CLI (Optional)
 

You can also use the GitHub CLI to open issues without leaving your terminal. Install the CLI and authenticate first:

gh auth login

Then run:

gh issue create \\
  --title "Bug: Crash on large file upload" \\
  --body "Steps to reproduce:\n1. ...\n2. ...\n" \\
  --label bug

 
Step 9: Track, Comment, and Close Issues
 

After submission:

• View comments and feedback from collaborators.
• Add more details by commenting under the issue.
• When the issue is resolved, click Close issue or use the GitHub CLI:

gh issue close 123