mlinhard / mockito

Automatically exported from code.google.com/p/mockito
0 stars 0 forks source link

Better Javadoc Styling #286

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
What steps will reproduce the problem?
1. Access the mockito API docs link: 
docs.mockito.googlecode.com/hg/latest/org/mockito/Mockito.html

What is the expected output? What do you see instead?
* The default styled Java Doc is shown.
* Since most of the Mockito documentation is in Javadoc. Making javadoc more 
legible and easy on eyes would help the developers a lot.
* Refer to following link on a sample stylesheet. 
http://sensemaya.org/maya/2009/07/10/making-javadoc-more-legible

What version of the product are you using? On what operating system?
* Latest

Please provide any additional information below.
The link provided has one more stylesheet link.
Also looking at Spring API doc to see their styles.

Original issue reported on code.google.com by dhara...@gmail.com on 2 Nov 2011 at 5:35

GoogleCodeExporter commented 9 years ago
API link should have http prefix... Right link is.. 

http://docs.mockito.googlecode.com/hg/latest/org/mockito/Mockito.html

Original comment by dhara...@gmail.com on 2 Nov 2011 at 5:36

GoogleCodeExporter commented 9 years ago
Sounds good, definitely worth trying out.

Original comment by szcze...@gmail.com on 2 Nov 2011 at 8:49

GoogleCodeExporter commented 9 years ago
Agreed it looks better now, and without too much work.
Had to add a few css rules though.

Original comment by brice.du...@gmail.com on 22 Nov 2011 at 4:53

GoogleCodeExporter commented 9 years ago
Check the latest documentation :)
http://docs.mockito.googlecode.com/hg/latest/org/mockito/Mockito.html

Original comment by brice.du...@gmail.com on 25 Nov 2011 at 4:57

GoogleCodeExporter commented 9 years ago
Perfect! Looks so much easier on eyes now!

Thank you.

Original comment by dhara...@gmail.com on 26 Nov 2011 at 9:03

GoogleCodeExporter commented 9 years ago

Original comment by szcze...@gmail.com on 16 Dec 2011 at 9:43

GoogleCodeExporter commented 9 years ago
I always use Firefox so I never noticed this before, but the code formatter is 
totally botched in IE 8.  Not a big deal to me personally, but I had a fellow 
developer who uses only IE right now, and it was impossible to read any of the 
code samples embedded in the Javadocs since 1.9.0

Original comment by kandpwel...@gmail.com on 21 Aug 2012 at 10:34

GoogleCodeExporter commented 9 years ago
Hi,

Stupid IE. Let's disable styling for IE < 9.

Original comment by brice.du...@gmail.com on 24 Aug 2012 at 9:55

GoogleCodeExporter commented 9 years ago
Makes perfect sense.

Original comment by szcze...@gmail.com on 25 Aug 2012 at 12:43

GoogleCodeExporter commented 9 years ago
Done, but cannot push on mockito docs repository due to Google Code bug 

Got a "URLError: [Errno 10054]" : 
http://code.google.com/p/support/issues/detail?id=28389

source : 
https://groups.google.com/forum/?fromgroups#!topic/google-code-hosting/w1x5ri8RN
r0

Original comment by brice.du...@gmail.com on 28 Aug 2012 at 4:25

GoogleCodeExporter commented 9 years ago
OK, the javadoc has been finaly been pushed successfully. Due to some changes 
at Google (see their issue here : 
http://code.google.com/p/support/issues/detail?id=28389)

Original comment by brice.du...@gmail.com on 15 Sep 2012 at 9:10