Getting involved

There are few ways you can to it

First of all, we would like to thank you for using our software, And even more thanks for your willing to help!

You do not need to know how to program in order to help us out. Help is not always contributing by code but also helping us with ideas. There are several ways to do so:

• Asking for new features
• Posting bug reports
• Develope

In this post we will cover all methods in great details.
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 links 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, containing a subject "Jce Manager feature request".

The other way, is to head over to our github issues page. Just create a new issue with the title "Feature request" and in the body give us a brief about your idea.
At the body please write as much as you can, so we would understand and get to work.

Note: We might not accept all features, some might not be as important as the others and we simply need to manage our time.

Back To The Top

Posting bug reports

JCE Manager Crashed? Something wen wrong?

Something went wrong... we test the software before we upload a new release. But if you are here, then something went wrong... :-(

For bugs, please do not send us e-mail. It will get lost in our inbox.

Go to our github issues page and browse through the issues. try to see if someone has the same issue, If so, Click on that issue and post your experience. Please add your JML.log (log file. it does NOT contain your password).

If your issue is new, you are more than welcome to open an issue post. Make sure that the title is short and informative. In the body, try to provide steps to reproduce + The problem + log file.
For 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 assume you know some basic stuff.

Please make sure that you have the following:

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

Install qt creator

Install git:
Under linux just use your package manager, apt-get, yum , pacman...
For example:

#Under Ubuntu
$ sudo apt-get install git-core
#under Arch linux
$ sudo pacman -S git

Under Mac OSX:
If you have Homebrew installed, install Git via the command

$ brew install git

If not, download the installer...

Under Windows:
Download the Git installer from the website, at the Installer Wizard, make sure you use git Bash.

Create a Github account**
Go to github.com and sign up.

Okay, Now we have everything we need to get started.
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 an essential for development collaborating.

To Setup git, fire up a terminal (in Windows use git bash)

And type:

# 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

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 the "Fork" button on top. It will create a copy of the software's code 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)

Let's call that URL repoPath from now on.

Now navigate to your working directory, in my case Dev folder.

~$ 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...

At this point you can do whatever 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