RAML 1.0 Release

16
Write once. Use many. Creative laziness encouraged.

Transcript of RAML 1.0 Release

Writeonce.Usemany.Creativelazinessencouraged.

RAML1.0RCRELEASED!!!

WHAT’SNEW

DataModelscomplexschemasandexamplesbecomesimplytypedmodelsthatcanbeusedforcodegeneration,clearinterpretation,examplegeneration,andyes– evenmulti-formatschemageneration.

OR

DataModelsdatamodelsareeasilypulledintoothermodels,usedasschemas/examples,andcanevenbestoredinlibrariesandnamespaced!

LibrariesresourceTypes,traits,schemas,examples,datatypes(models),andmorecanallbestoredinlibraries,whichcanthenbepulledintotheRAMLspecinanamespaced format– lettingyoureusewhatyouwant,andignorewhatyoudon’t.

OverlaysyourAPIdoesn’tjustliveinoneenvironment,soneithershouldyourdesign,documentation,ortests.Overlaysletyou“extend”yourRAMLspecforyourdevelopment,QA,andproductionenvironments.

OriginalSpec OverlaysettingProductionValues

Annotationsvendorextensionsshouldn’tbeapain,andinRAML– they’rejust“new”propertiesinyourspec.

Plusyoucanuselibrariesandoverlaystokeepannotationsseparatefromyourmainspec,meaning theyareonlyvisibletothevendoryouwantusing them,andoutofthewayofyourdevelopers/ techwriters/CEO!

Andalotmore…

Plus+

APIWorkbenchabrandnewIDEtodesignAPIsonlineANDoffline,builtontopofGitHub’sAtomproject,meaningcollaborationandversioninghaveneverbeeneasier!Finally,atoolfordeveloperstodesignAPIswith!

Andabrandnewsite+projectdirectory

ProjectsViewedOver17,000EveryDay!!!

RAML.orgAPIWorkbench.com

@ramlapi