[zanata/zanata-platform] cf4c56: Rest api docs (#291)

[GitHub]

  Branch: refs/heads/master
  Home:   https://github.com/zanata/zanata-platform
  Commit: cf4c56fa334009cedb304b7cf1cb5951a39f9cd1
      https://github.com/zanata/zanata-platform/commit/cf4c56fa334009cedb304b7cf1cb5951a39f9cd1
  Author: Carlos Munoz <chavo16 at hotmail.com>
  Date:   2017-05-08 (Mon, 08 May 2017)

  Changed paths:
    A api/zanata-common-api/README.md
    M api/zanata-common-api/etc/enunciate/enunciate.xml
    M api/zanata-common-api/pom.xml
    M api/zanata-common-api/src/main/java/org/zanata/rest/dto/Account.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/dto/ProcessStatus.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/dto/resource/AbstractResourceMeta.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/dto/resource/Resource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/dto/resource/TextContainer.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/dto/resource/TextFlow.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/AccountResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/AsynchronousProcessResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/CopyTransResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/FileResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/GlossaryResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/ProjectIterationLocalesResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/ProjectLocalesResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/ProjectResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/ProjectVersionResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/ProjectsResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/SourceDocResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/StatisticsResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/TranslatedDocResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/TranslationMemoryResource.java
    M api/zanata-common-api/src/main/java/org/zanata/rest/service/VersionResource.java
    R api/zanata-common-api/src/main/java/org/zanata/rest/service/package-info.java

  Log Message:
  -----------
  Rest api docs (#291)

* use annotations to improve resource labels in docs
* polish Account REST api docs
* increase enunciate version
* refactor authentication section
* asynchronous process resource documentation
* code review changes
* more review changes