Document using Swift with VSCode

[tomerd]

• installing directly
• dev containter
• document any issues to make this easier, and pursue fixing / reporting to swift team as appropriate

[0xTim]

Initial set up stuff:

Install VSCode
Install the following extensions:

• CodeLLDB
• Maintained Swift Development Environment
• Swift Language
• Swift Test Explorer

Open the settings for Swift SDE and set the language server mode to sourcekit-lsp and set the path to SourceKit to your Xcode installations version of the LSP, in my case it was /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/sourcekit-lsp
Under the Swift build parameters, pass -Xswiftc -Xfrontend -Xswiftc -serialize-debugging-options as a second option to align it with the test extension

Optional - set all the key shortcuts you use in Xcode to the same behaviours in VSCode

[0xTim]

cc @toddvarland ☝️

[VineFiner]

Does DocC help?

[0xTim]

@VineFiner How would DocC help?

[VineFiner]

How does swift server provide its own api documentation? Are there any best practices. I know OpenAPIKit

[0xTim]

I'm confused, what's API documentation got to do with a VSCode guide?