• Skip to primary navigation
  • Skip to main content
  • Skip to footer

Chintu Gudiya Foundation

  • What We Do
    • Blog
  • Who We Fund
  • Projects
  • Grants
  • Financials
Project Tech4Dev

Github Badges: How it fulfills Glific’s need

You are here: Home / Blog / Github Badges: How it fulfills Glific’s need

twitter sharing button Share this on Facebook

Github Badges: How it fulfills Glific’s need


June 29, 2020 by Satendra Rawat
Leave a Comment

GitHub badges, a consolidated way to present concise pieces of information about a project. These badges help in increasing the readability of the readme file because they provide metrics about the repositories that help the readers to get a clear idea of the repository very quickly just by scanning the attached badges.

For Glific, we’ve added badges. Let’s have a look at what was our expectations and how ti helped us to achieve it.

What we needed

For an open-source project, the readme should be sufficiently readable so that anyone can have a look at the readme and have a quick glance at the project. The badges can provide the following metrics:

  1. How can someone contribute to the project? This will help in attracting the right kind of contributors to our open source project.
  2. It will help to attract the investors as well by giving them more confidence about the product.
  3. Making sure the new contributor is not breaking any existing functionality.
  4. What is the frequency of maintaining the project?
  5. The level of code/test coverage?
  6. Whether the project is documented well?

For an open-source project, the readme should be more readable so that anyone can have a look at the readme and it should provide the users with a quick way to collect metrics about the repository.

How it helped or can help to achieve the expectations.

  1. These badges provide information simply and quickly.
  2. As it is visually appealing as well to the visitor, it will help to attract the right contributors as well as the sponsors/investors.
  3. Provide a quick overview of the quality of the product, how/who is maintaining it, what are the best practices we are following so that the new contributor can maintain that sanity as well.

The badges that we have added to the Glific repositories to cover several topics and areas. Starting with the license of the project, the list is below.

License

Public repositories on Github are often used to share open-source software. So the question is, how we can say that our repository is truly open-source?

For a repository to be truly open-source, we’ll need it to have a proper open-source license. In that way, the others are free to use, change, and distribute the software. A good way to catch the user’s attention to the license is by creating a badge. There are many ways to include badges about license and I found shields.io as the easiest. You can simply create the badge you want by filling the relevant details there. You can visit https://shields.io/category/license for more information.

Continuous Integration

As we are using the GitHub workflow for CI, we use the status badge as the Continuous Integration badge. You can have a badge for each of your GitHub Actions CI workflows.

For the significance, it shows whether the code changes are integrated and tested well before merging to the master branch. This will ensure that any new changes are not breaking the existing functionality.

Code coverage

The code coverage is an important thing to It displays the code coverage and test coverage of the project. 

The code coverage can be generated locally, but for an open-source project, it is recommended to automate it so that it will show the updated coverage all the time. For that, we have integrated codecov.io in CI so that, every time the CI runs, it generates the latest coverage report and update it to codecov.io and we’ve access the coverage data from there itself.

Hex

The Glific documentation is generated and hosted using Hex. The badge shows the version of Hex we are using for Glific.

Conclusion

As we can see the badges are giving a quick way to collect metrics about the repository. These were the few badges we have included till now, there are a lot of other relevant badges as well that we can include as the project grows such as Github issues, Chat (for discord), Size, Downloads and many more. You can check all of these out on shields.io or badgen.net.

Category iconBlog,  Open Source Software,  Tech Work Tag icongithub badges,  Glific,  Tech4Dev Project Updates

Reader Interactions

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Recommended reading

    Continuous integration & deployment for open source project

    “TO ERR IS HUMAN” – It is natural for human beings to make mistakes. Though it sounds ideal, you cannot (or must not) accommodate mistakes when people’s lives may depend on your software. Especially where users are interacting with your app in real-time and your code impacts their lives, errors must be minimized. How to do that?

    June 5, 2020 by Satendra Rawat

    Overview: Deploying Glific on AWS ECS fargate with CD in place

    The Glific project is being built by a distributed team, working across timezones. In addition to that, we have sub-teams for frontend and backend applications. This results in short release cycles, where we fix issues and release them quickly. To allow for quick integration and assessment of the work, the need for Continuous Integration and

    September 9, 2020 by Satendra Rawat

Tags

#Tech4Good 66A analysis analytics architecture ASHWINI Avni conference Coronavirus COVID-19 crm-platform dataexplorer design research Discounts freespeech FundImpact github badges Glific Google governance hasiru dala ideation internetfreedomfoundation Jan Swasthya Sahyog Koha Koha Challenges Koha configuration Koha features Lastmilesupport library medha-stpc openchs opencity opendata open source Partnerships sesta Social Change Software Team Collaboration tech Tech4Dev Project Updates whatsapp Work from Home Yenepoya

Categories

  • Blog
  • Essays
    • 2015
    • 2016
    • 2017
    • 2018
  • Focus Areas
    • Organisations Funded
      • Education
      • Environment
      • Health
      • India
      • Open Source Software
      • Other
      • Philanthropy
      • Sanitation
      • Sports
      • Women Empowerment
    • Tech Work
  • Projects
  • Pune 2018 Unconference
  • Tech4Dev Project Report
  • Uncategorized

Footer

  • What We Do
    • Blog
  • Who We Fund
  • Projects
  • Grants
  • Financials

Copyright © 2021 Chintu Gudiya Foundation. All rights reserved. | Photo Credits