Dear Release Team, Gavin informed me that the API doc at http://kbase.us/developer-zone/documentation/workspace-service/ is out of date—it should have been updated when the newer version of the workspace service was deployed to production. What is the current situation with the updating of these API docs—does it require a human to copy them somewhere, or should that happen automatically when a service is deployed to production? Also, please add Erik to the release-team mailing list. He is handling the web-facing part (adding the kbase “style” to the API docs). Thanks, Nomi Begin forwarded message:

From: Christopher Henry <[email protected]> Subject: Re: workspace docs on website out of date Date: July 2, 2014 at 11:39:23 AM PDT To: Nomi Harris <[email protected]> Cc: Gavin A Price <[email protected]>

Yes!

On Jul 2, 2014, at 1:36 PM, Nomi Harris <[email protected]> wrote:

...

Ok, so you’re saying the API doc at http://kbase.us/developer-zone/documentation/workspace-service/ already should have been updated to 0.1.6?

On Jul 2, 2014, at 11:34 AM, Gavin A Price <[email protected]> wrote:

...

production has been running 0.1.6 for months.

production is *also* running 0.0.5 but no one should be using that other than Chris for data transfer and job handling purposes.

-g

On 7/2/2014 11:24 AM, Nomi Harris wrote:

...

When the production version updates to 0.1.6 then the API doc should get updated during the deploy process.

On Jun 26, 2014, at 4:45 PM, Gavin A Price<[email protected]> wrote:

...

It's probably because 0.0.5 is still running in production at the workspace and workspace_service endpoints (I think those are right) because the data transfer is still ongoing and FBA still uses the workspace as a job runner.

0.1.6 is also running at the ws endpoint, but that's the version everyone should be using at this point.

-g

On 6/26/2014 4:39 PM, Nomi Harris wrote:

...

When a service is (re)deployed into production, its API doc is supposed to get pushed as well. I’m not sure why that didn’t happen in this case. I will investigate.

On Jun 26, 2014, at 4:37 PM, Gavin A Price<[email protected]> wrote:

...

It's been brought to my attention that we're still on version 0.0.5 of the workspace docs here: http://kbase.us/developer-zone/documentation/workspace-service/

Should we update to the 0.1.6 docs, which is currently in production? If so, Nomi, could you explain the process?

Thanks, Gavin