add-resource

To link external files into a plain specification, you can reference text-based files directly to provide additional context for code generation. This approach reduces repetitive content by integrating external schemas and data files.

Yes, you can use a JSON schema as an external reference in your specification. The functionality supports adding JSON, YAML, and markdown file formats to ensure your text-based files resolve correctly within the project structure.

When adding external resources to a specification, you must use relative file paths. The system ensures these paths resolve correctly within the project structure so that your text-based files are linked accurately.

The best way to include an OpenAPI spec in a functional spec is to link it as an external file. This provides API endpoint details directly within your plain specification without duplicating content.

Yes, this approach supports markdown and YAML files for code generation. You can integrate these text-based file formats as references to add necessary context to your plain specifications.

You should use external references instead of inline content to reduce the need for repetitive content. Linking external files like data files and schemas directly provides additional context while keeping your plain specifications concise.