Skip to content

Using GitHub

Links: 300 home

If you press ? anywhere in GitHub you will get keyboard shortcuts.

How to use GitHub issues

  • Once we create an issue it gets a unique number.
  • We can create milestones and then assign issues to milestones.
Milestones can be thought of as epic, issues can be thought of as user stories and maybe task lists in issues can be thought of as tasks.

attachments/Pasted image 20221016150810.jpg

  • We can have issue templates in .github/ISSUE_TEMPLATE folder.
  • We can also have issue forms, they are an extension of templates.
    • Issue forms are yml files whereas templates are md files.


How to use GitHub projects

  • It is a way to organise issues.


How to use GitHub releases

  • Major release:
    • The versions are incompatible with each other.
    • This means 1.0.0 won't be compatible with 2.0.0
  • Minor release:
    • Adding new functionality in a backwards compatible manner.
    • 1.1.0 and 1.2.0 will be minor release.
  • Patch:

    • Backward compatible bug fixes.
  • Alpha and beta can be thought of as pre releases.

  • Releases are based on git tags.
Generally in releases you will have zipped up version of you source code unless you have other binaries.

So whenever you go to a code base in GitHub always look for releases section to download the most stable version.

  • We can create a release from the UI.
  • We can automate this process of creating releases using GitHub actions and tags.
    • So suppose we have stable version we tag that particular commit with v0.1.0
    • We can have a GitHub action which looks for tags starting with v and then publishes them as a release.


Last updated: 2022-10-16