How to Contribute - Revision history

Sgothel at 05:31, 31 August 2013

2013-08-31T05:31:32Z

← Older revision		Revision as of 07:31, 31 August 2013
Line 15:		Line 15:
	* Adding [[Contributing a new feature or fix\|a new feature]]: This is the ultimate level of contribution to JogAmp. Before starting at this level, you should consult the [[Maintainer and Contacts#Maintainer\|module maintainer]] to make sure there's agreement about the direction you want to go. But other than that, you're limited only by your imagination.		* Adding [[Contributing a new feature or fix\|a new feature]]: This is the ultimate level of contribution to JogAmp. Before starting at this level, you should consult the [[Maintainer and Contacts#Maintainer\|module maintainer]] to make sure there's agreement about the direction you want to go. But other than that, you're limited only by your imagination.

	To contribute at an advanced level, you'll need to be able to build the JogAmp project ~~you want to contribute to. Here are some helpful links:~~		To contribute at an advanced level, you'll need to be able to [[How to Build\|build the JogAmp project]].

	* [[Building JOGL on the command line\|Building JOGL on the command line]]
	* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]
	* [{{SERVER}}/jogl/doc/HowToBuild.html How To Build JOGL]
	* [{{SERVER}}/jocl/doc/HowToBuild.~~html How To Build JOCL]~~

	= Git References =		= Git References =

Wwalker: Fixed link

2011-03-05T22:32:43Z

Fixed link

← Older revision		Revision as of 00:32, 6 March 2011
Line 7:		Line 7:

	* [[Downloading and installing JOGL\|Downloading and installing JOGL]]		* [[Downloading and installing JOGL\|Downloading and installing JOGL]]
	* [[Setting up an JogAmp project in your ~~favourite~~ IDE\|Setting up an JogAmp project in your ~~favourite~~ IDE]]		* [[Setting up a JogAmp project in your favorite IDE\|Setting up a JogAmp project in your favorite IDE]]

	= Advanced contributions =		= Advanced contributions =

Wwalker: Reordered to make clear what the different types of contribution are and to remove info that's now moved to the "Contributing a new feature or fix" page

2011-01-22T21:33:50Z

Reordered to make clear what the different types of contribution are and to remove info that's now moved to the "Contributing a new feature or fix" page

← Older revision		Revision as of 23:33, 22 January 2011
Line 1:		Line 1:
	= ~~Overview~~ =		= Basic contributions =

	~~Our modules have been~~ [~~http:/~~/~~blog~~.~~jausoft~~.~~com/2009/07/08/svn-to-git-migration-1/ migrated~~ to ~~git]~~, ~~thanks~~ to the ~~great git toolchain~~.~~<br>~~		* Reporting a bug on [{{SERVER}}/forum.html our forum]: This is helpful and a good first step to getting a bug fixed. If you're not quite sure what you're seeing is a bug, this is the best way to report it, rather than going straight to the bug database.
	~~In the past we were using~~ a ~~centralized repository only, ''SVN'', and you really needed access~~ to a central ~~repository~~.		* [[Jogl FAQ#Bugreports & Testing\|Submitting a bug report to our database]]: This is a very valuable contribution. A full bug report gives us a permanent record of the bug in a central location where we can easily refer to it later. You should always attach failing Java code to the bug report to help us reproduce it.

	~~Chose a media~~ to ~~offer your branch~~ to ~~the [[Maintainer~~ and ~~Contacts#Maintainer\|module maintainer]].~~		At this level, you only need to be able to download and use a JogAmp project like JOGL. Here are some helpful links:
	~~This may be via~~
	* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html#Individual%20Developer%20%28Participant%29 email]
	* [http://weblog.masukomi.org/wp-content/uploads/2008/03/config_remote_repo.~~svg http]~~
	* [http:~~//kernel.org/pub/software/scm/git/docs/howto/use-git-daemon.txt git]~~

	~~Surely it's most easy for us to access your git repository via the git protocol~~		* [[Downloading and installing JOGL\|Downloading and installing JOGL]]
	~~you may host on a free git server like~~ [[~~http://github.com github~~]].		* [[Setting up an JogAmp project in your favourite IDE\|Setting up an JogAmp project in your favourite IDE]]

	~~Just '''create a branch of your own and make it available''', then you may ask~~		= Advanced contributions =
	~~the [[Maintainer and Contacts#Maintainer\|module maintainer]] to pull, review and merge your branch.<br>~~
	~~[http://whygitisbetterthanx.com/#any-workflow Collaboration] using a [http://whygitisbetterthanx.com/#distributed distributed SCM] is easy.~~

	~~= Steps =~~		* Submitting a [[Contributing a new feature or fix\|bug report with a unit test]]: This not only documents the bug, but gives us a way to reproduce it in our automatic test suite. This insures that once the bug is fixed, it won't happen again later as the code is changed.
			* Submitting a [[Contributing a new feature or fix\|bug report with a unit test and a fix]]: This is the best possible way to insure that a bug gets fixed quickly, since you've submitted a complete package which the maintainer just needs to examine and approve.
			* Adding [[Contributing a new feature or fix\|a new feature]]: This is the ultimate level of contribution to JogAmp. Before starting at this level, you should consult the [[Maintainer and Contacts#Maintainer\|module maintainer]] to make sure there's agreement about the direction you want to go. But other than that, you're limited only by your imagination.

	* fork a [[Jogamp SCM Repositories\|SCM repository]]		To contribute at an advanced level, you'll need to be able to build the JogAmp project you want to contribute to. Here are some helpful links:
	* do with it as you ~~please while obeying the modules license and <i>the law</i>.~~
	* tell us about the ~~earth shaking improvements~~ you ~~made via the [http://jogamp.org/forum.html mailinglists/forum] and contact the [[Maintainer and Contacts#Maintainer\|module maintainer]]~~
	* if everything works fine we will probably integrate it soon, <b>if</b>
	** you include a [http://jogamp.org/git/?p=jogl.~~git;a=blob;f=src/junit/com/jogamp/test/junit/newt/TestGLWindows00NEWT.java <b>a junit test</b>] reflecting your changes / feature~~
	** you comply with the module's license and contribute under it's terms
	** we can <i>somehow</i> verify your identity, at least you use your <b>full name</b> in your [http:~~//help.github.com/git-email-settings/ git commits]~~

	~~For more details, see~~ [[~~Contributing a new feature or fix~~\|~~these instructions~~ on ~~how to contribute a new feature or fix~~]].		* [[Building JOGL on the command line\|Building JOGL on the command line]]
			* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]

	~~To actually build the beast, please refer to the following manuals:~~
	* [{{SERVER}}/jogl/doc/HowToBuild.html How To Build JOGL]		* [{{SERVER}}/jogl/doc/HowToBuild.html How To Build JOGL]
	* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]		* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]
	* [[Building JOGL on the command line\|Building JOGL on the command line]]
	* [[Downloading and installing JOGL\|Downloading and installing JOGL]]
	* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]
	* [[Setting up an JogAmp project in your favourite IDE\|Setting up an JogAmp project in your favourite IDE]]

	= Git References =		= Git References =

			Our modules have been [http://blog.jausoft.com/2009/07/08/svn-to-git-migration-1/ migrated to Git], thanks to the great Git toolchain. In the past we used a centralized Subversion repository, which required access to a central server.

			Our preferred method of Git collaboration is via the [[http://github.com free GitHub server]]. But you could also contribute via [http://www.kernel.org/pub/software/scm/git/docs/everyday.html#Individual%20Developer%20%28Participant%29 email], [http://weblog.masukomi.org/wp-content/uploads/2008/03/config_remote_repo.svg http], or the [http://kernel.org/pub/software/scm/git/docs/howto/use-git-daemon.txt Git daemon].

			* [http://whygitisbetterthanx.com/#any-workflow Collaboration with Git]
			* [http://whygitisbetterthanx.com/#distributed Distributed SCM with Git]
	* http://help.github.com/git-installation-redirect		* http://help.github.com/git-installation-redirect
	* http://help.github.com/git-email-settings/		* http://help.github.com/git-email-settings/
	* http://help.github.com/		* http://help.github.com/
	* [http://git.or.cz/course/svn.html GIT Manual for SVN Experts]		* [http://git.or.cz/course/svn.html GIT Manual for SVN Experts]

Mbien: /* Steps */

2011-01-19T20:44:44Z

Steps

← Older revision		Revision as of 22:44, 19 January 2011
Line 36:		Line 36:
	* [[Downloading and installing JOGL\|Downloading and installing JOGL]]		* [[Downloading and installing JOGL\|Downloading and installing JOGL]]
	* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]		* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]
	* [[Setting up an ~~Eclipse~~ project ~~that uses JOGL~~\|Setting up an ~~Eclipse~~ project ~~that uses JOGL]]~~		* [[Setting up an JogAmp project in your favourite IDE\|Setting up an JogAmp project in your favourite IDE]]
	* [[Setting up an IntelliJ IDEA project that uses JOGL\|Setting up an IntelliJ IDEA project that uses JOGL]]
	* [[Setting up a NetBeans project that uses JOGL\|Setting up a NetBeans project that uses JOGL]]

	= Git References =		= Git References =

Wwalker: Added link to new downloading page

2011-01-17T19:44:53Z

Added link to new downloading page

← Older revision		Revision as of 21:44, 17 January 2011
Line 34:		Line 34:
	* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]		* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]
	* [[Building JOGL on the command line\|Building JOGL on the command line]]		* [[Building JOGL on the command line\|Building JOGL on the command line]]
			* [[Downloading and installing JOGL\|Downloading and installing JOGL]]
	* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]		* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]
	* [[Setting up an Eclipse project that uses JOGL\|Setting up an Eclipse project that uses JOGL]]		* [[Setting up an Eclipse project that uses JOGL\|Setting up an Eclipse project that uses JOGL]]

Wwalker: Added links for other IDEs

2011-01-17T15:12:32Z

Added links for other IDEs

← Older revision		Revision as of 17:12, 17 January 2011
Line 36:		Line 36:
	* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]		* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]
	* [[Setting up an Eclipse project that uses JOGL\|Setting up an Eclipse project that uses JOGL]]		* [[Setting up an Eclipse project that uses JOGL\|Setting up an Eclipse project that uses JOGL]]
			* [[Setting up an IntelliJ IDEA project that uses JOGL\|Setting up an IntelliJ IDEA project that uses JOGL]]
			* [[Setting up a NetBeans project that uses JOGL\|Setting up a NetBeans project that uses JOGL]]

	= Git References =		= Git References =

Wwalker: Added link to new page

2011-01-15T21:50:13Z

Added link to new page

← Older revision		Revision as of 23:50, 15 January 2011
Line 35:		Line 35:
	* [[Building JOGL on the command line\|Building JOGL on the command line]]		* [[Building JOGL on the command line\|Building JOGL on the command line]]
	* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]		* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]
			* [[Setting up an Eclipse project that uses JOGL\|Setting up an Eclipse project that uses JOGL]]

	= Git References =		= Git References =

Wwalker: Added link to new page on feature/fix contribution

2011-01-10T22:27:58Z

Added link to new page on feature/fix contribution

← Older revision		Revision as of 00:27, 11 January 2011
Line 1:		Line 1:
	= Overview =		= Overview =

	Our modules have been [http://blog.jausoft.com/2009/07/08/svn-to-git-migration-1/ migrated to git],		Our modules have been [http://blog.jausoft.com/2009/07/08/svn-to-git-migration-1/ migrated to git], thanks to the great git toolchain.<br>
	thanks to the great git toolchain.<br>		In the past we were using a centralized repository only, ''SVN'', and you really needed access to a central repository.
	In the past we were using a centralized repository only, ''SVN'',
	and you really needed access to a central repository.

	Chose a media to offer your branch to the [[Maintainer and Contacts#Maintainer\|module maintainer]].		Chose a media to offer your branch to the [[Maintainer and Contacts#Maintainer\|module maintainer]].
Line 28:		Line 26:
	** you comply with the module's license and contribute under it's terms		** you comply with the module's license and contribute under it's terms
	** we can <i>somehow</i> verify your identity, at least you use your <b>full name</b> in your [http://help.github.com/git-email-settings/ git commits]		** we can <i>somehow</i> verify your identity, at least you use your <b>full name</b> in your [http://help.github.com/git-email-settings/ git commits]

			For more details, see [[Contributing a new feature or fix\|these instructions on how to contribute a new feature or fix]].

Wwalker: Added new link for more build details

2011-01-10T16:05:46Z

Added new link for more build details

← Older revision		Revision as of 18:05, 10 January 2011
Line 33:		Line 33:
	* [{{SERVER}}/jogl/doc/HowToBuild.html How To Build JOGL]		* [{{SERVER}}/jogl/doc/HowToBuild.html How To Build JOGL]
	* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]		* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]
			* [[Building JOGL on the command line\|Building JOGL on the command line]]
	* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]		* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]

Wwalker at 14:07, 10 January 2011

2011-01-10T14:07:19Z

← Older revision		Revision as of 16:07, 10 January 2011
Line 33:		Line 33:
	* [{{SERVER}}/jogl/doc/HowToBuild.html How To Build JOGL]		* [{{SERVER}}/jogl/doc/HowToBuild.html How To Build JOGL]
	* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]		* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]
			* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]

← Older revision		Revision as of 22:44, 19 January 2011
Line 36:		Line 36:
	* [[Downloading and installing JOGL\|Downloading and installing JOGL]]		* [[Downloading and installing JOGL\|Downloading and installing JOGL]]
	* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]		* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]
	* [[Setting up an ~~Eclipse~~ project ~~that uses JOGL~~\|Setting up an ~~Eclipse~~ project ~~that uses JOGL]]~~		* [[Setting up an JogAmp project in your favourite IDE\|Setting up an JogAmp project in your favourite IDE]]
	* [[Setting up an IntelliJ IDEA project that uses JOGL\|Setting up an IntelliJ IDEA project that uses JOGL]]
	* [[Setting up a NetBeans project that uses JOGL\|Setting up a NetBeans project that uses JOGL]]

	= Git References =		= Git References =

← Older revision		Revision as of 21:44, 17 January 2011
Line 34:		Line 34:
	* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]		* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]
	* [[Building JOGL on the command line\|Building JOGL on the command line]]		* [[Building JOGL on the command line\|Building JOGL on the command line]]
			* [[Downloading and installing JOGL\|Downloading and installing JOGL]]
	* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]		* [[Building JOGL in Eclipse\|Building JOGL in Eclipse]]
	* [[Setting up an Eclipse project that uses JOGL\|Setting up an Eclipse project that uses JOGL]]		* [[Setting up an Eclipse project that uses JOGL\|Setting up an Eclipse project that uses JOGL]]