Xcode Playgrounds: Example example doesn't look right

Originator:markd
Number:rdar://30329010 Date Originated:2/2/2017
Status:Open Resolved:
Product:Documentation Product Version:Version 8.3 beta (8W109m)
Classification:UI/Usability Reproducible:Always
 
Summary:
Hi!  Don't know if this is a playground rendering issue or a documentation issue, or both.

In the xcode playground markup, "the Example" documentation:

https://developer.apple.com/library/content/documentation/Xcode/Reference/xcode_markup_formatting_ref/Example.html#//apple_ref/doc/uid/TP40016497-CH58-SW1

When I enter the Example example:

/*:
  - example: *A simple `for` loop.*\
  This example shows a `for` loop that prints the numbers 1 to 5.\
 \
  `for index in 1...5 {`\
  `   print("index = \(index)")`\
  `}`}
 */


I get the attached image - an extra close curly brace, and the loop contents aren't indented even though there are spaces there)

(And are the newline escapes  actually necessary?  Seems kind of onerous)

Steps to Reproduce:


Expected Results:


Actual Results:


Version:
https://developer.apple.com/library/content/documentation/Xcode/Reference/xcode_markup_formatting_ref/Example.html#//apple_ref/doc/uid/TP40016497-CH58-SW1

Notes:


Configuration:
Version 8.3 beta (8W109m)
10.12.2 (16C67)


Attachments:
'Screen Shot 2017-02-02 at 11.21.07 AM.png' was successfully uploaded.

(image at http://imgur.com/a/PJTnL)

Comments


Please note: Reports posted here will not necessarily be seen by Apple. All problems should be submitted at bugreport.apple.com before they are posted here. Please only post information for Radars that you have filed yourself, and please do not include Apple confidential information in your posts. Thank you!