RAML 1.0 Release
-
Upload
michael-stowe -
Category
Software
-
view
3.194 -
download
0
Transcript of RAML 1.0 Release
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!