id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
13290	dependency on external jar file for admin js minification needs better documentation	Gabriel Hurley	Gabriel Hurley	"In revision [12371] jezdez added ``contrib/admin/media/js/compress.py``, which is very handy but is also dependent on the developer having downloaded and installed Google's [http://code.google.com/closure/compiler/ Closure Compiler]. That's further complicated by the fact that Closure Compiler relies on Java 6 (or Java 1.6 on Mac OS X, which was not the default shipped version of Java until Snow Leopard).

While I eventually figured out what compiler it was looking for from the help text on the ``-c`` flag ( ""path to closure compiler jar file""), having proper documentation of the external requirement, where to download the compiler from, a note about the potential trouble with Mac OS X, etc. would be more developer-friendly. Comments in the source and/or improved help text are probably the place to add the notes.

I'll write up a patch a bit later."		closed	Documentation	1.1		fixed	admin js compress		Accepted	1	0	0	0	0	0