swiftlang / swift

The Swift Programming Language
https://swift.org
Apache License 2.0
67.65k stars 10.38k forks source link

[SR-5535] No documentation leads to build-toolchain #48107

Open dabrahams opened 7 years ago

dabrahams commented 7 years ago
Previous ID SR-5535
Radar rdar://problem/33478170
Original Reporter @dabrahams
Type Bug
Additional Detail from JIRA | | | |------------------|-----------------| |Votes | 0 | |Component/s | Project Infrastructure | |Labels | Bug, Documentation, Website | |Assignee | None | |Priority | Medium | md5: a390792da905e46a6c6931bbea15b5a3

Issue Description:

I was trying to figure out how to work in Xcode with an in-development version of Swift, and I spent hours crawling around the web and our docs folder before stumbling on this file. Knowing how to do this is important for anyone working on Swift and especially important if they need to test changes that may affect swift-corelibs-foundation. In other words, it should be referenced prominently both from somewhere like https://swift.org/contributing/
and from https://github.com/apple/swift-corelibs-foundation/blob/master/Docs/GettingStarted.md

Also, there need to be instructions for what to do with the results of running this script. I find both
swift-nightly-install/Library/Developer/Toolchains/swift-LOCAL-2017-07-23-a.xctoolchain
swift-nightly-symroot/Library/Developer/Toolchains/swift-LOCAL-2017-07-23-a.xctoolchain. Which one should I use, and how should I use it?

dabrahams commented 7 years ago

@swift-ci create