Skip to content

improve description of use cases and getting started guides #304

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jun 20, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions assets/stylesheets/pages/_getting-started.scss
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
padding-left: 0;
display: grid;
gap: 1rem;

.resource {
border: 1px solid var(--color-fill-tertiary);
padding: 1rem;
Expand All @@ -18,7 +18,7 @@
grid-column-end: 3;
}
}

h3 {
padding-top: 0;
}
Expand All @@ -34,7 +34,7 @@
margin-bottom: 1rem;
}
}

@media (min-width: $grid-breakpoint) {
grid-template-columns: repeat(2, 1fr);
}
Expand All @@ -52,18 +52,18 @@
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(2, 1fr);
}
Expand All @@ -76,13 +76,13 @@ a.cta-secondary {
display: block;
padding: .5rem 0;
text-align: center;

&:hover {
background-color: var(--color-text);
color: var(--color-fill);
text-decoration: none;
}

&.external:after {
content: " ↗"
}
Expand Down
4 changes: 4 additions & 0 deletions assets/stylesheets/pages/_landing.scss
Original file line number Diff line number Diff line change
Expand Up @@ -143,6 +143,10 @@
@media (min-width: 1000px) {
grid-template-columns: repeat(2, 1fr);
}

li:nth-child(2n-1):nth-last-of-type(1) {
grid-column: span 2;
}
}

.getting-involved,
Expand Down
14 changes: 8 additions & 6 deletions getting-started/_use-cases.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Looking for a language reference? [The Swift Programming Language (TSPL)](https:
<li class="use-case">
<h3>Command-line Tool</h3>
<p class="description">
Build a cross-platform command-line tool.
Learn how to create cross-platform command-line tool such as short-lived interactive programs, or long-lived daemon that runs in the background.
</p>

<a href="/getting-started/cli-swiftpm" class="cta-secondary">Start tutorial</a>
Expand All @@ -18,7 +18,7 @@ Looking for a language reference? [The Swift Programming Language (TSPL)](https:
<li class="use-case">
<h3>Library</h3>
<p class="description">
Build a cross-platform library.
Learn how to create cross-platform library for sharing reusable code, or modularize large code-base.
</p>

<a href="/getting-started/library-swiftpm" class="cta-secondary">Start tutorial</a>
Expand All @@ -27,8 +27,9 @@ Looking for a language reference? [The Swift Programming Language (TSPL)](https:
<li class="use-case">
<h3>Web Service</h3>
<p class="description">
Use a web framework to build a web service.
Requires macOS or Linux.
Learn how to create a web-service using a web framework.
<br><br>
This guide requires macOS or Linux.
</p>

<a href="/getting-started/vapor-web-server" class="cta-secondary">Start tutorial</a>
Expand All @@ -37,8 +38,9 @@ Looking for a language reference? [The Swift Programming Language (TSPL)](https:
<li class="use-case">
<h3>iOS and macOS Application</h3>
<p class="description">
Use Swift and SwiftUI to build an app that works on iOS and macOS.
Requires macOS 12 and Xcode 14.
Learn how to create an iOS or macOS application using SwiftUI.
<br><br>
This guide requires macOS and Xcode.
</p>

<a href="/getting-started/swiftui" class="cta-secondary">Start tutorial</a>
Expand Down
22 changes: 18 additions & 4 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,15 +72,29 @@ Swift is a general-purpose programming language built using a modern approach to
<li>
<h3>Apple platforms</h3>
<p>
Swift is a powerful and intuitive programming language on macOS, iOS, watchOS, tvOS and beyond. Swift code is safe by design, yet also produces software that is optimized to run lightning-fast.
Swift is a powerful and intuitive programming language optimized when running on iOS, macOS, and other Apple platforms.
<br><br>
Apple offers a wide variety of frameworks and APIs that make applications developed for these platforms unique and fun.
</p>
<a href="https://developer.apple.com/swift/resources/" class="cta-secondary">Learn more</a>
</li>
<li>
<h3>Cross-platform Command-line</h3>
<p>
Writing Swift is interactive and fun, the syntax is concise yet expressive.
Swift code is safe by design and produces software that runs lightning-fast.
<br><br>
SwiftArgumentParser and Swift's growing package ecosystem make developing cross-platform command-line tools a breeze.
</p>

<a href="https://developer.apple.com/swift/resources/" class="cta-secondary">Learn more</a>
<a href="/getting-started/cli-swiftpm" class="cta-secondary">Learn more</a>
</li>
<li>
<h3>Server</h3>
<h3>Server and Networking</h3>
<p>
Ever dreamed of using the same programming language on both your mobile applications and their server back-ends? Swift's small footprint, quick startup time, and deterministic performance make it specifically suitable for Server applications.
Swift's small memory footprint, quick startup time, and deterministic performance make it a great choice for server and other networked applications.
<br><br>
SwiftNIO and Swift's dynamic server ecosystem bring joy to developing networked applications.
</p>

<a href="/server" class="cta-secondary">Learn more</a>
Expand Down