Skip to content

Commit a864b9c

Browse files
committed
[NFC] GettingStarted: Replace list of forum topics with search link for troubleshooting
Take advantage of the tags that we attach to such topics. Also tune the GitHub issues link by analogy.
1 parent 59f44f9 commit a864b9c

File tree

1 file changed

+10
-12
lines changed

1 file changed

+10
-12
lines changed

docs/HowToGuides/GettingStarted.md

+10-12
Original file line numberDiff line numberDiff line change
@@ -311,23 +311,19 @@ You will need to slightly tweak the paths for other build configurations.
311311
In many situations, there are several errors, so scrolling further back
312312
and looking at the first error may be more helpful than simply looking
313313
at the last error.
314-
- Check if others have encountered the same issue on the [Swift Forums](https://forums.swift.org/c/development/compiler) or on [Swift repository 'Issues' tab][Swift Issues]. Here is a list of threads that describe common issues:
315-
* [Problems with `build-script` building compiler with `–xcode`](https://forums.swift.org/t/problems-with-build-script-building-compiler-with-xcode/53477)
316-
* [Error building the compiler (even with ninja)](https://forums.swift.org/t/error-building-the-compiler-even-with-ninja/54834)
317-
* [Build failure on Apple MacBook Pro with Apple M1 Chip](https://forums.swift.org/t/build-failure-on-apple-silicon-m1-mac-mini/45011)
318-
* [CMake cannot compile a test program](https://forums.swift.org/t/build-failure-locally/55695)
319-
* [Building Swift compiler from source fails when not using Ninja](https://forums.swift.org/t/building-swift-compiler-from-source-fails-when-not-using-ninja/54656)
320-
* [ALL_BUILD Target failing at validation](https://forums.swift.org/t/help-building-swift-in-xcode-error/49728)
321-
* [“gtest/gtest.h” not found while compiling the compiler](https://forums.swift.org/t/gtest-gtest-h-not-found-in-typeref-cpp-while-compiling-the-compiler/44399)
322-
- If you still could not find a solution to your issue, feel free to create a new Swift Forums thread in the [Development/Compiler](https://forums.swift.org/c/development/compiler) category:
323-
- Include information about your configuration and the errors you are seeing.
314+
- Check if others have encountered the same issue on the
315+
[Swift forums][build-script-issues-forums] or in
316+
[our issues][build-script-issues-github].
317+
- If you still could not find a solution to your issue, feel free to create a new Swift forums thread in the [Development/Compiler](https://forums.swift.org/c/development/compiler) category:
318+
- Include the command, information about your environment, and the errors
319+
you are seeing.
324320
- You can [create a gist](https://gist.github.com) with the entire build
325321
output and link it, while highlighting the most important part of the
326322
build log in the post.
327323
- Include the output of `utils/update-checkout --dump-hashes`.
328324

329-
[Swift Issues]: https://github.com/swiftlang/swift/issues
330-
[Swift Forums]: https://forums.swift.org
325+
[build-script-issues-forums]: https://forums.swift.org/search?q=tags%3Abuild-script%2Bhelp-needed
326+
[build-script-issues-github]: https://github.com/swiftlang/swift/issues?q=is%3Aissue+label%3Abuild-script+label%3Abug
331327

332328
## Editing code
333329

@@ -706,3 +702,5 @@ If you see mistakes in the documentation (including typos, not just major
706702
errors) or identify gaps that you could potentially improve the contributing
707703
experience, please start a discussion on the forums, submit a pull request
708704
or file a bug report on [Swift repository 'Issues' tab][Swift Issues]. Thanks!
705+
706+
[Swift Issues]: https://github.com/swiftlang/swift/issues

0 commit comments

Comments
 (0)