[jsr362-observers:] [jsr362-experts:] Re: Color coding JavaDoc changes
- From: Kito Mann <
, Ed Burns <
- Subject: [jsr362-observers:] [jsr362-experts:] Re: Color coding JavaDoc changes
- Date: Tue, 6 Aug 2013 10:09:04 -0400
- List-id: <jsr362-experts.portletspec3.java.net>
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
* Listen to the Enterprise Java Newscast:
* JSFCentral Interviews Podcast:
* Sign up for the JSFCentral Newsletter: http://oi.vresp.com/?fid=ac048d0e17
On Tue, Aug 6, 2013 at 2:20 AM, Martin Scott Nicklous <
> 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?
> 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
> > 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
> > I think it would be very helpful to Portlet 3.0 developers and
> > container implementors.
> > Best Regards,
> > Neil