🚚 Rename person file to people

Renames `person.tsp` to `people.tsp` because SWAPI uses the plural name
in most documentation.

Includes this in the new CONTRIBUTING documentation. Moves some existing
developing documentation from README into the new documentation.

CONTRIBUTING.md

@@ -0,0 +1,20 @@
+# 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](./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.

README.md

@@ -34,21 +34,5 @@ Follow these steps to consume the generated Open API specification for SWAPI.
  ./node_modules/swapi-typespec/swapi.openapi.yaml
  ```
 
-## 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](./src) contains the TypeSpec (`.tsp`) files
-
-### Notes
-
-- Using `@resource` adds _all_ REST operations. Thus, the spec files explicitly
- configure `list` and `read` operations because SWAPI only supports those.
-
 [swapi]: https://swapi.dev
 [typespec]: https://microsoft.github.io/typespec/

src/main.tsp

@@ -1,2 +1,2 @@
 import "./root.tsp";
-import "./person.tsp";
+import "./people.tsp";