[threeten-dev] [threeten-develop] Package structure for Threeten in JDK

[Richard Warburton]

>
> Some folks blame this on the Java language, some on the javadoc
> (alphabetical),
> some on the IDE's completion methods.
>

Its not unreasonable to expect IDE's to suggest completions to more
frequently used methods.  The eclipse project has already got this somewhat
implemented.


> A big part of Threeten is a framework for defining how date-time objects
> inter-operate.
> And along with that framework is a best-practice for using the API.
> Personally, I'd rather not make a distinction between framework methods
> and not but some found it to be an important distinction.
> Feel free to call any public method, but there is a preferred way to use
> the API.
> The 'do' prefix identifies framework methods.


I don't think the 'do' prefix is hugely liked by anyone - but the issue is
that interfaces only allow for public methods, so there's no way to
correctly scope some methods within the Java Language.  For reference there
was some issue tracker discussion on this topic:

https://github.com/ThreeTen/threeten/issues/122

regards,

  Richard