DEV Community

Cover image for What you can do using project planning on GitHub
Antonio Anderson
Antonio Anderson

Posted on • Updated on

What you can do using project planning on GitHub

All in one place 🤯

This is my brief summary about my experience using Github Project constantly for the first time.

Projects on Github is an adaptable, flexible tool for planning and tracking work on GitHub, giving to your team the advantage of having a global view of your entire project.

A project is and adaptable spreadsheet that integrates with your issues and pull requests on Github to help you plan and track your work effectively. You can create and customize multiple views by filtering, sorting, grouping your issues and PR's, adding custom fields to track meta-dada specific to your team, and visualize work with configurable charts. Rather than enforcing a specific methodology, a project provides flexible features you can customize to your team's needs and processes.

What I can do using GitHub Issues/Projects 🤔

I had experience with several project management tools and starting to use Github Projects gave me a productivity gain both personally and with my team.

Below I list some important things that Github Projects can bring to your team.

  • Break down large issues into smaller issues
  • Communicate
  • Make use of the description and README
  • Use views
  • Have a single source of truth
  • Use automation
  • Use different field types

You can learn more about the best practices for any projects here

How to create a project on Github 📑

To start a project at Github first you need a repository, or if you are working for a organization you can easily find a tab named Projects.

Github initial screen showing how access Projects part

Now you can create a project clicking at New Project button. When prompted to select a template, click a template or to start with an empty project, click Table or Board. Then, click Create.

Selecting a new template for a new Project

For users projects 👨‍💻

User projects can track issues and pull requests from the repositories owned by your personal account, is a way to start managing your own projects!

To start a project in your profile, you just need to click on Projects tab and create one, the same way for a specific repo or organization.

Initial page for Github Projects

Custom descriptions and README 📝

You can set your project's description and README to share the purpose of you project provide instructions on how to use the project, and include any relevant links.

1 - Start navigate to your project

2 - In the top-right, click ... to open the menu and click Settings to access the project settings.

Navigate to open Menu

Now you can add a short description to your project, under "Add a description", type your description in the text box and click Save.

Showing description area

Under "README", type your content in the next box.

Showing readme area

Learning more 📚

Thanks for reading! If you’re interested in learning more check out these links:

GitHub Issues Docs: (check out the quickstart guide!)

My Links 🔗


Feel free to give me a feeadback, in one of these languages: PTBR/EN.


Top comments (3)

incrementis profile image
Akin C.

Hello Antonio Anderson,

thanks for your article.
It was interesting and motivated me to play around with GitHub's "Projects" features.

There are some trivial typos I want to mention here.
"Wehn prompted to select a template"
you mean maybe
"When prompted to select a template"
"for a specific repo ou organization."
you mean maybe
"for a specific repo or organization."
"click a temple or to start with an empty project"
This line is a bit confusing because I'm not entirely sure what you mean by the word "temple".

santosant profile image
Antonio Anderson

Thank you for your feedback. I apologize for any errors in the previous version of the article, as it was written hastily without the opportunity for revisions. The text has now been updated. Once again, thank you for your input.

josethz00 profile image
José Thomaz

didn't knew about this github feature, will use it! thanks!