First pass at the new Getting Started page #174
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1 +1,2 @@ | ||
| @import "pages/getting-started"; | ||
| @import "pages/swift-evolution"; |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,50 @@ | ||
|
|
||
| .guide-list { | ||
| list-style: none; | ||
| padding-left: 0; | ||
| } | ||
|
|
||
| .use-case-list { | ||
| list-style: none; | ||
| padding-left: 0; | ||
| display: grid; | ||
| gap: 1rem; | ||
|
|
||
| .use-case { | ||
| border: 1px solid var(--color-fill-gray); | ||
| padding: 0 1rem; | ||
| border-radius: 4px; | ||
| display: flex; | ||
| flex-direction: column; | ||
|
|
||
| h3 { | ||
| line-height: 1.4; | ||
| font-size: 1.4rem; | ||
| } | ||
|
|
||
| p { | ||
| flex-grow: 1; | ||
| color: var(--color-secondary-label); | ||
| } | ||
| } | ||
|
|
||
| @media (min-width: 1000px) { | ||
| grid-template-columns: repeat(3, 1fr); | ||
| } | ||
| } | ||
|
|
||
| a.cta-secondary { | ||
| border-radius: var(--border-radius); | ||
| border: 1px solid var(--color-text); | ||
| color: var(--color-text); | ||
| display: block; | ||
| margin: 1rem 0; | ||
| padding: .5rem 0; | ||
| text-align: center; | ||
|
|
||
| &:hover { | ||
| background-color: var(--color-text); | ||
| color: var(--color-fill); | ||
| text-decoration: none; | ||
| } | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,35 @@ | ||
| ## Go Further | ||
|
|
||
| Ready to dive deeper? Here are some hand-picked resources covering about various Swift features and use. | ||
|
|
||
| <ul class="guide-list"> | ||
| <li class="guide"> | ||
| <h3>Concurrency</h3> | ||
| <p class="description"> | ||
| When you have code that needs to run at the same time as other code, it's important to choose the right tool for the job. | ||
| </p> | ||
|
|
||
| <p class="description"> | ||
| We'll take you through the different kinds of concurrent tasks you can create in Swift, show you how to create groups of tasks, and find out how to cancel tasks in progress. We'll also provide guidance on when you may want to use unstructured tasks. | ||
| </p> | ||
|
|
||
| <div class="links links-list-nostyle"> | ||
| <a href="/">Read guide</a> | ||
| </div> | ||
| </li> | ||
|
|
||
| <li class="guide"> | ||
| <h3>Testing</h3> | ||
| <p class="description"> | ||
| Unit testing is an essential tool to consistently verify your code works correctly. Learn about the built-in testing features in Xcode, using XCTest. | ||
| </p> | ||
|
|
||
| <p class="description"> | ||
| Find out how to organize your tests and run them under different configurations using test plans, and discover how to automate testing and efficiently work with the results. | ||
| </p> | ||
|
|
||
| <div class="links links-list-nostyle"> | ||
| <a href="/">Read guide</a> | ||
| </div> | ||
| </li> | ||
| </ul> | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,174 +1,12 @@ | ||
| ## Installing Swift | ||
|
|
||
|
There was a problem hiding this comment. @tomerd I pieced the install section from other concepts but your input here would be very valuable. |
||
| If you don't have Swift installed, [install it first](/install). To test that you have Swift installed, run `swift --version` in the terminal. | ||
|
|
||
| ### Swift Package Manager | ||
|
|
||
| When you install Swift you’ll also get the latest stable version of the Swift build tool and package manager, also known as Swift Package Manager, or SwiftPM . | ||
|
|
||
| SwiftPM does lots of things: | ||
| - Build your project with `swift build`. | ||
| - Test your project with `swift test`. | ||
| - Run your project with `swift run`. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,34 @@ | ||
| ## Using Swift | ||
|
|
||
| Below are some examples of the many use cases of Swift. | ||
|
|
||
| <ul class="use-case-list"> | ||
| <li class="use-case"> | ||
| <h3>Build a Web Server (Vapor)</h3> | ||
| <p class="description"> | ||
| Use the open-source Vapor framework to build a web API entirely with Swift. | ||
| Requires macOS or Linux. | ||
| </p> | ||
|
|
||
| <a href="/getting-started/vapor-web-server" class="cta-secondary">Start tutorial</a> | ||
| </li> | ||
|
|
||
| <li class="use-case"> | ||
| <h3>Build a Command-line Tool</h3> | ||
| <p class="description"> | ||
| Build a command-line tool using Swift and SwiftPM. | ||
| </p> | ||
|
|
||
| <a href="/getting-started/cli-tool" class="cta-secondary">Start tutorial</a> | ||
| </li> | ||
|
|
||
| <li class="use-case"> | ||
| <h3>Build an app for Apple platforms</h3> | ||
| <p class="description"> | ||
| Use Swift and SwiftUI to build an app that works on iOS and macOS. | ||
| Requires macOS 12 and Xcode 14. | ||
| </p> | ||
|
|
||
| <a href="/" class="cta-secondary">Start tutorial</a> | ||
| </li> | ||
| </ul> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| --- | ||
| layout: page | ||
| title: Build a Command-line Tool | ||
| --- | ||
|
|
||
| TODO |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| --- | ||
| layout: page | ||
| title: Build a Web Server | ||
| --- | ||
|
|
||
| TODO |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.