+1 --Jason
sent from my DROID On Jan 17, 2013 7:41 PM, "Josh Elser" <[email protected]> wrote: > +1 on both accounts. Would help alleviate confusion over what is the > public api and what is publicly callable. > > On 01/17/2013 05:48 PM, Eric Newton wrote: > >> +1 >> >> I also like the idea of tagging the public API. >> >> >> >> On Thu, Jan 17, 2013 at 5:07 PM, David Medinets <[email protected] >> >**wrote: >> >> +1 >>> >>> On Thu, Jan 17, 2013 at 4:40 PM, Christopher <[email protected]> >>> wrote: >>> >>>> I would like to propose and encourage the use of the @since javadoc tag >>>> >>> for >>> >>>> all new public/protected methods in the public API, as well as new >>>> >>> classes >>> >>>> in the public API. >>>> >>>> I would also like to propose and encourage the words "since <version>" >>>> be >>>> used as the first two words of all @deprecated javadoc tags. >>>> >>>> These are enormously useful for documenting to users when a new feature >>>> >>> was >>> >>>> added/changed, as well as informing developers how long something has >>>> >>> been >>> >>>> around, and thus informing decisions about when it is safe to remove or >>>> change. >>>> >>>> -- >>>> Christopher L Tubbs II >>>> http://gravatar.com/ctubbsii >>>> >>> >>> >>
