Using Github Releases
Releases
Releases are a feature of github that allow developers to ship binaries for download so that the users of the software don't have to compile the source code and the developers don't have to add binary files to their repos.
Note
In this article Release means a new version of software that is
Released
By the developer for users to install and use.
Usage
It's pretty easy to use. You get a link in your git-hub repo's mainpage named as Releases. Here is a screen-shot.
- If you didn't have any releases :
- If you had releases :
You can navigate to it and follow instructions and then create a new/first release.
Some points to remember
-
Try to publish the release as compressed files and/or standalone executables.
-
Don't include unnecessary files such as cache and
.git
folder. -
Use Pre-release option if your release is unstable.
-
Version your Release to track record for changes.
Tutorial
This tutorial is meant for those who for some reason could not publish a release. It is a simple step to step guide to publish a release.
Note
I have used my notex repo for this tutorial.
Step 1 :
Enter the release option.
Step 2 :
Choose/Click(Whatever the heck you can call it) Create a New Release
.
Step 3 :
- Write description
- Upload files
- Select If a Pre-release
- Publish The Release
A filled Release Form looks like :