ICON Community: How to Submit an Issue on GitHub

2 min read

Icon Community: How to Submit an Issue on GitHub

ICON is a blockchain architecture that enables the various devices that comprise the internet of things (IoT) to interoperate as one. ICON’s ultimate vision is for every device on the Internet to be connected to a decentralized network using ICON’s technology.

The ICON network is the blockchain-powered infrastructure for a global decentralized network of communities and economies. ICX is the native token of the ICON network. It helps run the entire ecosystem and helps represent the ICON token on exchanges.

The project is led by a team of passionate blockchain developers and technologists who are committed to making our world a more open, fair, and accessible place.

As an ICON community member, especially if you’re a non-developer, submitting bug reports and suggestions is one of the most valuable contributions you can make. In this article, you’ll learn how to submit issues directly to ICON-related GitHub repositories.

What is GitHub?

ICON is an open-source blockchain project, which means its codebase can be viewed, worked on, and improved by anyone in the community. ICON’s codebase is hosted on GitHub, an online collaboration platform where users can contribute code, engage in discussions, submit bug reports, view historical code changes, and more.

On GitHub, ICON’s codebase is organized into different repositories or repos. You can think of a repo as a project-specific storage area for code and related discussions. For example, the codebases for Goloop and the ICON Tracker are stored in different repos.

What are GitHub Issues?

GitHub Issues is a feature that’s built into GitHub repos. As its name implies, GitHub Issues is for creating and tracking issues that are related to a repo. In many cases, development teams use GitHub Issues to track bug reports and feature requests. Think about how unproductive developers would be if they had to constantly keep tabs on Discord, Telegram, and their email inboxes to stay on top of bug reports! By using GitHub Issues, developers are able to focus their time and energy on writing code.

To streamline the development of the ICON project, we recommend users submit bug reports and feature requests directly to GitHub Issues.

Let’s walk through how to submit an issue on GitHub now!

How to Create a GitHub Account

Feel free to skip to the next section if you already have one.

First, go to GitHub and click “Sign Up” in the upper right corner.

Sign up for a GitHub account.
Sign up for a GitHub account.

Next, walk through the interactive signup process.

Sign up for a GitHub account.
Sign up for a GitHub account.

How to Find ICON GitHub Repos

Broadly speaking, repos relating to the ICON project can be found in the GitHub organizations below:

  • icon-project – Repos for core projects like Goloop, BTP, and Nexus.
  • icon-community – Repos for community-led projects like the icon.community website, CPS, and grant templates.
  • sudoblockio – Repos for the ICON community tracker API and front end.

To make things easier, we’ve also compiled a list of popular ICON repos here.

How to Create a GitHub Issue

To create a GitHub issue, navigate to a repo and click the “Issues” tab.

GitHub repo for Nexus.
GitHub repo for Nexus.

On the issues page, click “New Issue”. Next, provide a title and description of the issue. The GitHub editor supports Markdown for the description, so feel free to use text formatting if needed. Finally, click “Submit New Issue” to complete the process.

Fill in the issue details.
Fill in the issue details.

Some repos have standardized templates for submitting issues. For example, on ICON’s Nexus frontend repo, clicking on the “Issues” tab will bring you to a page where you can choose between “bug report” and “feature request” templates.

GitHub issue templates.
GitHub issue templates.

Clicking “Get Started” for a template will populate the editor with a predefined template. If the issue you want to submit can be adequately covered by one of the templates, we recommend using the template to help speed things up.

GitHub predefined issue template.
GitHub predefined issue template.

After submitting an issue, it will be visible in the “Issues” tab for the developers to see.

Summary

As an open source project, community contribution is very important for ICON. If you’re not a developer, submitting bug reports and feature requests via GitHub Issues is a great way to start contributing to the ICON project. If you have any questions about ICON’s GitHub repositories, be sure to join the ICON Discord and start a discussion!

Via this site