Where does one report issues with the swift.org website?

Nevin · November 4, 2018, 5:18am

I was just looking at the Guided Tour page, and the code example for multiline strings talks about leading indentation, but the example renders with no leading indents:

Use three double quotation marks ( """ ) for strings that take up multiple lines. Indentation at the start of each quoted line is removed, as long as it matches the indentation of the closing quotation marks. For example:
1 | let quotation = """
2 | Even though there's whitespace to the left,
3 | the actual lines aren't indented.
4 | Except for this line.
5 | Double quotes (") can appear without being escaped.
6 | 
7 | I still have \(apples + oranges) pieces of fruit.
8 |     """

Should I file a Jira bug or what?

John_McCall · November 4, 2018, 5:25am

There's a plan in place to open up development of swift.org and make it easier to contribute to. Ted Kremenek (@tkremenek) might be able to give an update on that. For now, filing a Jira bug against Project Infrastructure might be the best bet.

zoul · November 4, 2018, 10:07am

I am very fond of static websites, swift.org seems to be a good candidate for that. And then the collaboration workflow would be as easy as sending a PR; the website would update automatically after merging.

benrimmington · November 4, 2018, 12:18pm

The Swift Programming Language book is tracked in Radar, not JIRA.

ladislas · November 4, 2018, 1:56pm

@John_McCall @tkremenek

I know the founders of HackMD if you're interested.

It's basically Google Docs for markdown documentation. People can make suggestions, collaborate, etc.

Ethereum is using it: link 1, link 2

I've been using it for my company's internal documentation and we are loving it.