EBI is an Outstation of the European Molecular Biology Laboratory. Promoting services with annotation and registries Hamish McWilliam, EMBL-EBI External Services
Promoting services with annotation and registries Roles of annotation Service documentation Interface description Usage details Service promotion Advertising services Client development Copy n' paste development Hints and tips
Promoting services with annotation and registries Service Documentation Human readable documentation End-users Developers Interface description documentation WSDL, WADL, etc. Included in generated code (WSDL2Java, wsdl.exe, etc.) Mainly for developers Used by service registries
Promoting services with annotation and registries Advertising services Interface description documentation (WSDL, WADL, etc.) “The provider's voice” Seed annotation for registries Registry annotations Additional details and experiences Registry specific
Promoting services with annotation and registries Levels of annotation None Anonymous services Minimal: interface description (WSDL, WADL, etc) For example: systomonas_webservice, AnalysisWSAppLabImplService, etc. Generic: details provided by multi-service frameworks For example: Soaplab Thin layer of specific details For example: Dispatcher and Jdispatcher services Detailed documentation
Promoting services with annotation and registries Sample clients Simple working clients Guide to service usage Illustration of workarounds Help in client tool-kit evaluation Problem verification Plug-in and go usage