Sha256: f412ce6f6e3c2c114d2ad0ff5ca07d43385148383e0e6f9f56e83cd0860c0219

Contents?: true

Size: 865 Bytes

Versions: 5

Compression:

Stored size: 865 Bytes

Contents

# ❗️Convention over Configuration (CoC)

- `tag name` represents `controller name` and determine `paths file name`.
  - For example, If `controller name` is `Api::V1::UsersController`, `tag_name` is `api/v1/user`. and `paths file name` is `api/v1/user.yml`

- `_` of `components/{schemas,requestBodies, ...} name` convert `/` when save file.
  - For example, If `components/schemas name` is `Api_V1_User`, `components/schemas file name` is `api/v1/user.yml`.
  - `_` is supposed to be used to express `namespace`.
  - format is `Namespace1_Namespace2_Model`.

- `.` of `components/{schemas,requestBodies, ...} name` convert `/` when save file.
  - For example, If `components/schemas name` is `api.v1.User`, `components/schemas file name` is `api/v1/user.yml`.
  - `.` is supposed to be used to express `namespace`.
  - format is `namespace1.namespace2.Model`.

Version data entries

5 entries across 5 versions & 1 rubygems

Version Path
r2-oas-0.3.1 docs/setting/COC.md
r2-oas-0.3.0 docs/setting/COC.md
r2-oas-0.2.0 docs/setting/COC.md
r2-oas-0.1.3 docs/setting/COC.md
r2-oas-0.1.2 docs/setting/COC.md