cl-deck-builder2/templates/docs.md
2024-03-05 22:11:33 -05:00

1.2 KiB

{# doc.0: URL; doc.1: Documentation; doc.2: Methods; doc.3: Params; #}

# Project Documentation

This page is automatically generated. Sections are organized like so:

    * METHOD ROUTE PARAMETERS
      DOCSTRING

`METHOD` is usually either `GET` or `POST`, but could be any of the
[HTTP Methods](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods).

The `ROUTE` is the `URI` endpoint on the application, e.g. `/builder`.

Each `ROUTE` has `PARAMETERS`. Currently, the parameters are parsed by
hand. As the application matures, the parameters will come more into
play.

The `DOCSTRING` is written by me, the developer, and is intended to
provide context on the purpose of the route.

The API follows a basic pattern:

    GET /<base-page>

This will display the main page for the item `<base-page>`.

    DELETE /<base-page>
    PATCH /<base-page>
    POST /<base-page>

If `<base-page>` may have an operation done on it (create,
retrieve, update, delete some values), there will be a matching method
for `DELETE`, `PATCH`, `POST`, etc.

# API Index
{% for doc in docs %}## {{ doc.2 }} {{ doc.0 }} {{ doc.3 }}
{{ doc.1 }}

{% endfor %}