[ANN] Release 3.0

[Andrus Adamchik]

I am glad to announce 3.0 release of Agrest (ex. LinkRest).

This is the release with all the package renaming, so when upgrading prepare to change a bunch of imports and rename a few imported classes in your code. See UPGRADE-NOTES [1] for details.

But there are things beyond pure renaming... The first limited version of "design-first" REST API workflow is available [2]. So you can write a YAML file in OpenAPI (aka Swagger) format. The framework provides a "library" YAML with all the Agrest protocol keys, so combining the two you get (1) great API documentation for the consumer, and (2) operational stubs of your endpoints. This is just the first step. We will continue working on other OpenAPI flows (such as "code-first") to ensure Agrest APIs are easy to consume.

Finally we filled a few big gaps in the documentation (e.g. an important topic on writing custom request stages [3]). Note that the docs currently look very basic, as we moved to a new docs platform (Asciidoc). Providing better styling is the next step.

Release notes:

#285 OpenApi integration: Design First Approach
#331 LinkRest to AgREST rebranding: Rename packages and files
#333 Actualize documentation
#338 Update gh-pages static documentation
#340 Removing API deprecated in 2.x
#341 Create example of application
#342 Add add an extra method to AgClient that takes a configuration callback


[1] https://github.com/agrestio/agrest/blob/master/UPGRADE-NOTES.md
[2] https://agrest.io/docs/workflow.html#design-first-approach
[3] https://agrest.io/docs/framework.html#customizing-request-processing

Cheers,
Andrus