Skip to main content

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

  • From: Kito Mann < >
  • To: , Ed Burns < >
  • Subject: [jsr362-experts:] Re: [jsr362-observers:] Color coding JavaDoc changes
  • Date: Tue, 6 Aug 2013 10:09:04 -0400

I think this an excellent idea. I don't think there are any legal
restrictions, and I think Ed (who came up with that scheme) would like to
see others adopt it. Ed?

___

Kito D. Mann | @kito99 | Author, JSF in Action
Virtua, Inc. | http://www.virtua.com ;| JSF/Java EE training and consulting
http://www.JSFCentral.com ;| @jsfcentral
+1 203-998-0403

* Listen to the Enterprise Java Newscast:
*http://w<http://blogs.jsfcentral.com/JSFNewscast/>
ww.enterprisejavanews.com*
* JSFCentral Interviews Podcast:
http://www.jsfcentral.com/resources/jsfcentralpodcasts/
* Sign up for the JSFCentral Newsletter: http://oi.vresp.com/?fid=ac048d0e17


On Tue, Aug 6, 2013 at 2:20 AM, Martin Scott Nicklous <
>
 wrote:

> 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