1
0
mirror of https://github.com/oceanprotocol/docs.git synced 2024-11-26 19:49:26 +01:00

document what's going on in the parameter examples

This commit is contained in:
Matthias Kretschmann 2018-11-30 15:21:08 +01:00
parent 19eb6588e1
commit fa725c5e6f
Signed by: m
GPG Key ID: 606EEEF3C479A91F

View File

@ -60,6 +60,21 @@ SwaggerMeta.propTypes = {
}
const ParameterExample = ({ properties }) => (
//
// HEADS UP!
//
// Constructing the example request body here based on the defined properties
// where `key` is the name of the property, and `properties[key].example` is
// the value for it.
//
// Making prism.js pick up on the strings only output didn't work out so well
// so the spans and classes this plugin would add are added manually here. Since we
// include the prism css file globally this is picked up by that.
//
// But this can only work if all keys and values are manually constructed here, which
// is almost impossible to do for deep nested objects or arrays as example value. Running
// that code through `JSON.stringify` won't syntax highlight that part of the code.
//
<pre className="language-json">
<code className="language-json">
{'{'}