It occurred to me, if we're creating a new dmg and new IRIS, then we're releasing services that weren't "in" this release, aren't we? So they weren't tested or checked for API docs or release notes, but they get released anyway? Am I missing something here about what it means to be "in" a release?

Update on API docs (for services "in" this release):

On Aug 9, 2013, at 9:55 AM, Nomi Harris <nlharris@lbl.gov> wrote:

Thanks. expression still has an extra webroot that needs to be removed.
Now fixed

Most of the modules now have API docs in the right place. The only exceptions:
functional_ortholog_predictor (no dir in http://140.221.84.191/services/docs/)
(is fine, I just looked in the wrong place the first time)

assembly: No obvious API doc in http://140.221.84.191/services/docs/assembly/
seems to have CLI documentation but not API

matR: has dir but no API doc
Still no API doc

shock_service: there is a "shock_store" (empty) directory in http://140.221.84.191/services/docs/ but no shock dir. Maybe a Makefile problem?
This is still the case

typecomp: Has there been a decision that it doesn't need API docs since it's for internal use? Seems like it would still be useful to have API docs for the use of internal people.
I  agree with this. :-)

As for the release notes, almost all the developers have now created or updated them, so yay! The only two services that are "in" this release and not just internal or dependencies, that lack up-to-date release notes, are:
KBaseFBAModeling [but I kind of feel sorry for that module--it had a hard day today, what with unexpectedly having its lib and docs dirs removed]
Workspace service

Nomi



On Aug 8, 2013, at 9:31 AM, Shane Canon <scanon@lbl.gov> wrote:


I fixed auth and expression.

--S

On Aug 8, 2013, at 9:22 AM, Nomi Harris <nlharris@lbl.gov> wrote:

On Aug 7, 2013, at 7:58 PM, Michael Sneddon <mwsneddon@lbl.gov> wrote:

Nearly all of the services that have been deployed passed the initial doc testing.

The two exceptions are 'sim_service', which is not deploying API docs at all (needs to add the proper doc generation and deployment code to its Makefile), and 'search', which was deployed to a test VM that I couldn't find (not available from t1 by ssh search ??), and has no docs appearing here: http://140.221.84.191/services/docs/search/

Bob fixed the Makefile and the API doc should appear when sim_service is redeployed.

In addition, several modules do have proper documentation that seems to be properly deployed, but is not appearing here: http://140.221.84.191/services/docs . It's probably just a proxy issue, but here is the list of those modules:

auth_service
The doc now appears where it should but there is an extra self-referential webroot link in http://140.221.84.191/services/docs/authorization_server/ so that you can go to, for example,

_______________________________________________
Release-team mailing list
Release-team@lists.kbase.us
https://lists.kbase.us/mailman/listinfo/release-team