Chapter 1. Overview:

"using universal network such as HTTP"

RECOMMEND something like: 

"using the common network data transport of HTTP"

2.1. SOAP and WSDL

"
This schema-based approach allows developers to generate the code for types and operations into their preferred native programming language. Code is generated using a client web service toolkit. Some popular web service toolkits are: 

    *
      Apache Axis or CXF to generate Java
    *
      Suds to generate Python
    *
      Savon to generate Ruby
"

The notion of code generation applies but is not a requirement. RECOMMEND:

"
This schema-based approach allows developers to use API types and operations in their preferred native programming language. Some popular web service toolkits for client development are:
    *
      Apache Axis or CXF for Java
    *
      Suds for Python
    *
      Savon for Ruby
"

3.1. Installation


"-DWANT_CONTRIB:BOOL=TRUE -DWITH_AVIARY:BOOL=TRUE"

MUST be changed to

"-DWANT_CONTRIB:BOOL=TRUE -DWITH_AVIARY:BOOL=TRUE -DWITH_MANAGEMENT:BOOL=TRUE"

4.1. JobId

"It is a string that encodes two positive floating point numbers such as 1.0, 84.3, 2004.68."

MUST be changed to:

"It is a string that encodes two positive integer numbers separated by a dot such as '1.0', '84.3', '2004.68'."

Chapter 7. Security

"Aviary supports submissions and queries over a secure SSL connection with mutual authentication. To enable this advanced feature, use remote configuration to add the SSLEnabledAviaryScheduler and SSLEnabledQueryServer features."

RECOMMEND change to:

"Aviary supports job submissions, management and queries over a secure SSL connection with mutual authentication. To enable this advanced feature, use remote configuration to add the SSLEnabledAviaryScheduler and SSLEnabledQueryServer features. These features have parameters for specifying client and server certificate file locations as well as a certificate authority (CA) file and/or directory."