Updated flavorstash readme
This commit is contained in:
parent
42e082fdd1
commit
9240f1c609
@ -5,4 +5,37 @@ between different websites or applications. This could be used on a website by
|
|||||||
presenting the json data and allowing the user to copy it and paste it on
|
presenting the json data and allowing the user to copy it and paste it on
|
||||||
another site.
|
another site.
|
||||||
|
|
||||||
|
## Use cases
|
||||||
|
* Any application or site where a list of flavorings is maintained.
|
||||||
|
|
||||||
|
## Implementation Suggestions
|
||||||
|
* For websites, make the json available to copy (to export) or paste and submit (to import).
|
||||||
|
* For applications, allowing both to save/load from file and clipboard is suggested.
|
||||||
|
|
||||||
|
## Implementation Details
|
||||||
|
The schema is as simplified as possible, meaning only the `vendor` and `flavor` fields are
|
||||||
|
required for each record.
|
||||||
|
|
||||||
|
[
|
||||||
|
{ "vendor":"TFA", "flavor":"Smooth" }
|
||||||
|
]
|
||||||
|
|
||||||
|
Additional application-specific data can be included:
|
||||||
|
|
||||||
|
[
|
||||||
|
{ "vendor":"TFA", "flavor":"Smooth", "extra":{ "is_additive":true }}
|
||||||
|
]
|
||||||
|
|
||||||
|
### Standard Extra keys
|
||||||
|
The following keys are standardized and should not be used for any other purpose than specified.
|
||||||
|
|
||||||
|
Application-specific data can (and should) be namespaced using dots, eg. `my_mixer_app.favorite`.
|
||||||
|
|
||||||
|
| Key | Type | Description |
|
||||||
|
| ------------- | -------- | ----------------------------------------- |
|
||||||
|
| `g_ml` | decimal | The specific gravity in grams per 1ml |
|
||||||
|
| `is_additive` | bool | If `true` the flavor is an additive |
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue
Block a user