Skip to main content

[jsr362-experts:] Re: [jsr362-observers:] Color coding JavaDoc changes

  • From: Martin Scott Nicklous < >
  • To:
  • Subject: [jsr362-experts:] Re: [jsr362-observers:] Color coding JavaDoc changes
  • Date: Tue, 6 Aug 2013 08:20:09 +0200

Hi Neil,

absolutely! great idea! ... just need to figure out how to do it ... :-)

That possibility had never occurred to me, but I think it makes for very
clear reading. And I imagine that you could create a "plain vanilla"
version without the color coding for the final release by just leaving out
the css files (if you wanted to).

Would the JSF folks have anything against us copying their basic mechanism
for doing the highlighting, or would there be license restrictions that
would speak against us doing so?

regards,
Scott


Neil Griffin 
< >
 wrote on 05.08.2013 23:57:56:

> From: Neil Griffin 
> < >
> To: 
> " "
>  <jsr362-
>  >,
> Date: 05.08.13 23:58
> Subject: [jsr362-observers:] [jsr362-experts:] Color coding JavaDoc
changes
>
> Hi Scott,
>
> Would you consider adopting a CSS-based color-code convention for
> changes to the Portlet 3.0 JavaDoc?
>
> For example, if you look at the JSF 2.2 main JavaDoc page:
> http://javaserverfaces.java.net/nonav/docs/2.2/javadocs/index.html
>
> ... you will see some color coded backgrounds for the changed text,
> with a corresponding legend at the bottom:
>
> Blue: Added in this version of the spec
> Gray: Modified in this version of the spec
> Purple: Deleted or deprecated in this version of the spec
>
> In addition, if you mouse-over these color coded areas, the mouse
> cursor will change to "2.2" in order to indicate the version of the
change.
>
> I think it would be very helpful to Portlet 3.0 developers and
> container implementors.
>
> Best Regards,
>
> Neil



[jsr362-experts:] Color coding JavaDoc changes

Neil Griffin 08/05/2013

[jsr362-experts:] Re: [jsr362-observers:] Color coding JavaDoc changes

Martin Scott Nicklous 08/06/2013

[jsr362-experts:] Re: [jsr362-observers:] Color coding JavaDoc changes

Kito Mann 08/06/2013

[jsr362-experts:] Re: [jsr362-observers:] Color coding JavaDoc changes

Edward Burns 08/07/2013

[jsr362-experts:] Re: [jsr362-observers:] Color coding JavaDoc changes

Edward Burns 08/07/2013

[jsr362-experts:] Re: [jsr362-observers:] Color coding JavaDoc changes

Werner Keil 08/07/2013

[jsr362-experts:] Re: [jsr362-observers:] Color coding JavaDoc changes

Werner Keil 08/07/2013

[jsr362-experts:] Re: [jsr362-observers:] Re: Color coding JavaDoc changes

Martin Scott Nicklous 08/08/2013

[jsr362-experts:] Re: [jsr362-observers:] Re: Color coding JavaDoc changes

Werner Keil 08/08/2013

[jsr362-experts:] Re: [jsr362-observers:] Re: Color coding JavaDoc changes

Edward Burns 08/13/2013

[jsr362-experts:] Re: [jsr362-observers:] Re: Color coding JavaDoc changes

Werner Keil 08/13/2013
 
 
Close
loading
Please Confirm
Close