[gardening] add missing "clone TSC" step to bootstrap instructions

Also sorted, reformatted and updated versions of existing `git clone` steps.
swiftlang · Jul 8, 2021 · 2c7df48 · 2c7df48
1 parent 4fd4df4
commit 2c7df48
Showing 1 changed file with 45 additions and 34 deletions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -129,40 +129,51 @@ It is used on bare systems to bootstrap the Swift toolchain (including SwiftPM),
 The bootstrap script requires having [CMake](https://cmake.org/) and [Ninja](https://ninja-build.org/) installed.
 Please refer to the [_Get Started_ guide](https://github.com/apple/swift/blob/main/docs/HowToGuides/GettingStarted.md#installing-dependencies) on the Swift project repository for installation instructions.
 
-1. Clone [llbuild](https://github.com/apple/swift-llbuild) beside the SwiftPM directory.
-
-```bash
-$> git clone https://github.com/apple/swift-llbuild llbuild
-```
-
-Note: Make sure the directory for llbuild is called "llbuild" and not
-    "swift-llbuild".
-
-2. Clone [Yams](https://github.com/jpsim/yams) beside the SwiftPM directory.
-
-```bash
-$> git clone https://github.com/jpsim/yams
-```
-
-3. Clone [swift-driver](https://github.com/apple/swift-driver) beside the SwiftPM directory.
-
-```bash
-$> git clone https://github.com/apple/swift-driver
-```
-
-4. Clone [swift-argument-parser](https://github.com/apple/swift-argument-parser) beside the SwiftPM directory and check out tag with the [latest version](https://github.com/apple/swift-argument-parser/tags).
-
-For example, if the latest tag is 0.3.1:
-```bash
-$> git clone https://github.com/apple/swift-argument-parser --branch 0.3.1
-```
-
-5. Clone [swift-crypto](https://github.com/apple/swift-crypto) beside the SwiftPM directory and check out tag with the [latest version](https://github.com/apple/swift-crypto/tags).
-
-For example, if the latest tag is 1.1.3:
-```bash
-$> git clone https://github.com/apple/swift-crypto --branch 1.1.3
-```
+Clone the following repositories beside the SwiftPM directory:
+
+1. [swift-argument-parser] and check out tag with the [latest version](https://github.com/apple/swift-argument-parser/tags).
+
+   For example, if the latest tag is 0.4.3:
+   ```sh
+   $> git clone https://github.com/apple/swift-argument-parser --branch 0.4.3
+   ```
+
+2. [swift-llbuild] as llbuild
+   ```sh
+   $> git clone https://github.com/apple/swift-llbuild llbuild
+   ```
+   > Note: Make sure the directory for llbuild is called "llbuild" and not "swift-llbuild".
+
+3. [swift-tools-support-core]
+   ```sh
+   $> git clone https://github.com/apple/swift-tools-support-core
+   ```
+
+4. [Yams] and checkout tag with the [latest version](https://github.com/jpsim/Yams.git/tags) before 5.0.0.
+
+   For example, if the latest tag is 4.0.6:
+   ```sh
+   $> git clone https://github.com/jpsim/yams --branch 4.0.6
+   ```
+
+5. [swift-driver]
+   ```sh
+   $> git clone https://github.com/apple/swift-driver
+   ```
+
+6. [swift-crypto] and check out tag with the [latest version](https://github.com/apple/swift-crypto/tags).
+
+   For example, if the latest tag is 1.1.6:
+   ```sh
+   $> git clone https://github.com/apple/swift-crypto --branch 1.1.6
+   ```
+
+[swift-argument-parser]: https://github.com/apple/swift-argument-parser
+[swift-crypto]: https://github.com/apple/swift-crypto
+[swift-driver]: https://github.com/apple/swift-driver
+[swift-llbuild]: https://github.com/apple/swift-llbuild
+[swift-tools-support-core]: https://github.com/apple/swift-tools-support-core
+[Yams]: https://github.com/jpsim/yams
 
 #### Building