Skip to content

Latest commit

 

History

History
28 lines (18 loc) · 816 Bytes

CONTRIBUTING.md

File metadata and controls

28 lines (18 loc) · 816 Bytes

Contributing

Developing

Run scripts

Use npm run to list all available scripts. The release script executes a “release build.” The CI build uses this script.

Directory structure

  • src contains the TypeSpec (.tsp) files

TypeSpec conventions

  • Separate files by type. Name files using the plural form, which SWAPI uses in its documentation.

  • Using @resource adds all REST operations. Thus, the spec files explicitly configure list and read operations because SWAPI only supports those.

    As a result, this project does not use @typespec/rest at all. Instead, it only needs @typespec/http for the API definitions.

  • Use backticks to escape properties that are TypeSpec keywords. For example,

    `model`: string; // Used in starships.tsp