Proposal: multi-line strings (e.g. description) in JSON

When maintaining Swagger files in the JSON format, it’s rather difficult to write long multi-line strings, for example in the description field. #292 provides a good example:

{
"description": "| Header 1 | Header 2 | Header 3 |\n|----------|----------|----------|\n| Data 1   | Data 2   | Data 3   |"
}

I am proposing to support array of strings in addition to raw string in certain fields like description, notes, etc.

{
"description": [
  "| Header 1 | Header 2 | Header 3 |",
  "|----------|----------|----------|",
  "| Data 1   | Data 2   | Data 3   |"
]}

Thoughts?

/cc @shelbys @raymondfeng

[shelbys]

@webron - I don’t think we’re talking about the same thing. To be clear we want to be able to do is the following, and just have the tools do description.join(''):

"description": [
  "Line1",
  "Line2",
  "Line3"
]

Keep in mind we have a ton of Specs spread across many teams, so switching to YAML is no trivial thing. Honestly, I prefer it personally, but that doesn’t mean I can force it on everyone

[fehguy]

Json can use \n. Yaml has native mutli-line strings. Closing, as anything else will be confusing to everyone.