jce-manager/_posts/2014-10-02-how-to-get-involved.md

6.8 KiB

layout title date categories image img
post How You Can Get Involved 2014-10-04 22:34:25 Help Git /JceManager/assets/images/posts/big-data.jpg big-data.jpg

Ok, You want to get involved...

######There are a few ways you can help

First of all, thank you for using our software, And even more thanks for your willing to help! Lest start from the top.

No you dont need to know how to code in order to help us out! Yes, Ill say it again in a different way... Help is not always contributing by code. There are several ways of doing so...

In this post we will cover all methods in great detail.
Note that all these methods are welcome in all Open-Source software and it will help you getting involved in most of them.

You can click on one of the above to skip to that section.

# Asking For New Features ######You love the software and you have a great idea

If that is the case, and you do have a great idea. The simple way of doing so is to contact the Developer.
You can send Liran Or Sagi an e-mail. At the mail subject please write "JCE Manager - feature request"

Please do not send twice, and do not get angry if we don't reply right away. We both are students (Just like you) and we code on our free time.

The other way, is to head over to our github issues page. Now just create a new issue with the title
"feature request - (a short description)"
At the body please write as much as you can, so we would understand and get to work.

Note: we might won't accept all features, some might not be as important as the others, and just need to manage our time...

Back To The Top


# Posting Bug Reports ######JCE Manager Crashed? Something wen wrong?

Okay, sorry if something went wrong... we really test the software like CrAzY before we upload a new release. But if you are here, then something unecpected happend.

For bugs, please do not send us e-mails. it will get inbox lost...

Go to our github issues page and browse though the issues. try to see if someone has the same issue. If so, Click on that issue and post your experience. Plus paste the content of your log file.

If your issue is new, you are more then welcome to open an issue. Make sure that the title is short and informative. At the body, try to provide steps to reproduce + The problem + log file. for an example:

1. login
2. click on GPA tab
3. click on clear

Problem: Software crash

Log:

17/09/2014 00:07:13	DEBUG 		 Start : JCE Manager Launched int main(int, char**)
17/09/2014 00:07:13	DEBUG 		 Local : Hebrew Local Loaded
17/09/2014 00:07:36	DEBUG 		 CSV : Getting path for csv file from user...
17/09/2014 00:07:42	DEBUG 		 CSV : User Chose:  "/home/username/test.csv"
17/09/2014 00:07:42	DEBUG 		 CSV : Atempting to export the Schedule...
17/09/2014 00:07:42	DEBUG 		 CSV : Exported Successfully
17/09/2014 00:07:47	DEBUG 		 End : JCE Manager Ended Successfully With A Return Code:  0

Note: The Log file will be in the application folder. the name of the file is JMLog.log

Back To The Top


# Code ######"Talks are cheap, Show me the code"

If you got this far, I can asume that you know some basic stuff.

Please make sure that you have the following:

  1. Qt Creator
  2. git
  3. a github account

Note: if you want to program under Windows you might come though some issues. Just Google it. UNIX and UNIX like systems are most recomended (Linux / Mac OSX)

Install qt creator. Download the installer... (I dont need to explain how right?).

Install git:
Under linux just use your package manager, apt-get, yum , pacman... for an example : {% highlight bash %} #Under Ubuntu $ sudo apt-get install git-core #under Arch linux $ sudo pacman -S git {% endhighlight %}

Under Mac OSX: If you have Homebrew installed, install Git via the command {% highlight bash %} $ brew install git {% endhighlight %} If not, download the installer...

Under Windows: Download the Git installer from the website, at the installer wizzard, make shure you use git Bash. Now Cross your fingers and hope that it went well...

Create A Github account
Go to github.com and sign up.

Okay, Now we have every thing we need to get started. well, one more thing...
If it is the first time you installed git we need to set it up.

Note: We are not going to learn about git, If you dont know how to use it, Google it! It's essential for collaborating with us, and in general it's really good to know.

To Setup git, fire up a terminal (in Windows git bash... or something like it... please choose a better OS ).

And type: {% highlight bash %}

Setup your name

$ git config --global user.name "YOUR NAME"

Setup your email - same as e-mail at github!

$ git config --global user.email "YOUR EMAIL ADDRESS"

For having some Color indicators in the terminal

$ git config --global color.ui auto {% endhighlight %}

And We Are Ready!!

To start messing arround with the code, you will want to fork the repo. Go To JCE Manager github repo, and click on the "Fork" button on top. that will create a copy of the software on your account.

Then You will want to pull the source code to your computer. copy the URL address of the copy you've just created (should be some thing like: https://github.com/yourusername/JceManager.git)

Lets call that URL repoPath from now on.

Now navigate to your working directory, in my case Dev folder. You will then f

{% highlight bash %} ~$ cd Dev ~/Dev/$ git clone repoPath

Now You Have The Code on your local computer...

~/Dev/$ cd JceManager ~/Dev/JceManager$ ls | grep *.pro #the file you see at the output is the qt creator project file... you are ready to code... {% endhighlight %}

At this point you can do what ever you want with the code and push to your github account. If you want us to pull code from you, it could be a bug fix, a new feature you coded or whatnot just send us a pull request at github!

Back To The Top