Upload
michael-stowe
View
3.196
Download
0
Embed Size (px)
Citation preview
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!
APIWorkbenchabrandnewIDEtodesignAPIsonlineANDoffline,builtontopofGitHub’sAtomproject,meaningcollaborationandversioninghaveneverbeeneasier!Finally,atoolfordeveloperstodesignAPIswith!