Specify default code listing language for DocC catalog

[denil-ct]

Motivation

Resolves #20

Modifications

• Added CDDefaultCodeListingLanguage to info.plist
• Updated ambiguous language highlightings

Result

Swift code blocks no longer needs to be explicitly marked as such.

Test Plan

Files inside the docc archive - Tested and verified with both explicit and non-explicit swift markings.
Files outside the docc archive - TBD

[czechboy0]

Thanks @denil-ct!

Were you able to test that after this addition, when you preview the docs locally, you get syntax highlighting for Swift even for code blocks without the explicit annotation? Would be good to do this, and add this to the Test Plan section of your PR description.

[denil-ct]

Were you able to test that after this addition, when you preview the docs locally, you get syntax highlighting for Swift even for code blocks without the explicit annotation? Would be good to do this, and add this to the Test Plan section of your PR description.

Yes, I tested it for the one I removed.

[czechboy0]

Ok, to summarize, please just fix these up and we're good to go:

• revert the removal of the explicit listing name in Contributing-...md
• edit the PR description to say that you tested the change manually by removing one of the annotations and still seeing the syntax highlighting

Thanks!

[denil-ct]

The default listing language is very helpful in code snippets in documentation comments above type definitions in Swift files, where folks frequently omit the language name.

So I had a concern regarding this. Won't the plist only affect whatever is listed within the docc archive?

I tried adding something like this

But it generated the non-highlighted version

However on explicitly marking swift, it is correctly highlighted.

[czechboy0]

Hmm that's unfortunate, not sure if expected behavior? cc @ethan-kusters @franklinsch

[czechboy0]

This PR fixes the issue, we'll investigate code listings coming from code comments separately. Looks good, thanks!

[denil-ct]

@czechboy0 This comment seems to imply this is only applicable for listings within the bundle.

[simonjbeaumont]

@swift-server-bot test this please