scala-js/scala-js-website

Multiple libraries listed as JDK extensions for `java.time`

matomer opened this issue · 1 comments

In the library page both scalajs-java-time and scala-java-time are listed as JDK extensions for java.time, however both seem to be compatible with scalajs (one is only compatible with scalajs and the second is platform independent). Additionally the first listed dependency seems to have been abandoned since the last commit was over a year ago and the description says "This library is a work in progress.".

Without knowing the differences between the libraries I assume that the second dependency should be used since it has had commits lately which means that it is probably healthier than the first one.

I think the first one should be removed or at least "demoted" below the first one unless there's some material difference I'm missing between the two in which case it should probably be documented.

Sciss commented

It should be clearly highlighted the status of the library. For example, after finding out that SimpleDateFormat is not remotely correctly implemented in scala-java-time, the author of the library noted:

this implementation of SimpleDateFormat is not really for production use, it is only a minimal set of stubs to make DateTimeFormatter work on scala-java-time. I'd discourage its direct use

This is of course a valid approach for a library, but the website should prominently indicate libraries that are not meant for production, since the front page opens with a big checkmark "Correctness", and one can easily get the impression that the projects listed under 'libraries' are somehow blessed.