Before we branch the 1.0 release, I would suggest we split the public API according to the
<module>.client.api.*: the general client API for anyone working with errai
<module>.client.framework.*: module extension points, considered more like an SPI
The idea is to have two levels of public API, clearly identified by subpackage names.
One for working with errai (api.*) and one for extending errai (framework.*).
This allows users to focus on what they need, expecting most implementations to rely on
client API (api.*), whereas integration with 3rd party technology would rely on the
extension API (framework.*).
Javadocs should only be available for those subpackages and deprecation rules only allow
changes to that API in between major releases.
I've already prepared the workspaces module, but didn't touch the bus module yet.
Let me know what you think. Once we've come to an agreement, I would go ahead and
the 1.0 release branch according to those guidelines.
Show replies by date