Properly Outdent Code Blocks in Discussion

[mattt]

For example, this code block renders as:

[samsymons]

@mattt Near as I can tell, this appears to come from usage of text-indent to indent code blocks inside SwiftDoc.

My CSS is rusty, but text-indent appears to only indent the first line within an element, which would explain the strange behaviour here. I found that by replacing text-indent with an adjusted padding value locally, it looks better:

[mattt]

@samsymons You know what, you're absolutely right — this is a CSS issue, not a problem with the indentation normalization code itself. Thanks for saving me the trouble of trying to hunt that down!

My reason for the text-indent was to improve the readability of declaration code blocks, which often run onto subsequent lines (without indentation, it's unclear that subsequent lines are a continuation of the previous one). However, that CSS rule was too general, and applied to code blocks in documentation as well. That should be a straightforward change.

[samsymons]

@mattt Ahh, that makes perfect sense, having the indentation inside declaration code blocks is definitely clearer. 😄

I'd be happy to open a PR against SwiftDoc which fixes this up!

[mattt]

I'd be happy to open a PR against SwiftDoc which fixes this up!

@samsymons That'd be great! If you don't mind, that'd be a big help. Please let me know if you have any problems at all getting setup locally for CSS development. Aside from me and @kaishin, I don't think anyone else has really touched that, so I'd be very interested to know if there's anything we missed in the documentation or tooling around that.

[mattt]

Moving this back over to swift-doc.