A RAML example fragment named BankAccountsExample.raml is placed in the examples folder. What is the correct syntax to reference the fragment?

A RAML example fragment named BankAccountsExample.raml is placed in the examples folder. What is the correct syntax to reference the fragment?

• A. example: !include examples/BankAccountsExample.raml
• B. fragment: include examples/BankAccountsExample.raml
• C. include: BankAccountsExample.raml
• D. example: BankAccountsExample.raml

Answer: (A)

In RAML, embedding external content such as an example fragment is done with the YAML !include directive. Since BankAccountsExample.raml is placed in the examples folder, the correct syntax to reference it is: example: !include examples/BankAccountsExample.raml. The !include tag tells the RAML parser to insert the contents of that file at that point, so the actual fragment appears in the example instead of just a filename. Other forms that omit the include directive, or use a different keyword, won’t pull in the file content and won’t work.

In RAML, embedding external content such as an example fragment is done with the YAML !include directive. Since BankAccountsExample.raml is placed in the examples folder, the correct syntax to reference it is: example: !include examples/BankAccountsExample.raml. The !include tag tells the RAML parser to insert the contents of that file at that point, so the actual fragment appears in the example instead of just a filename. Other forms that omit the include directive, or use a different keyword, won’t pull in the file content and won’t work.