From 036a15d13ec5d776135b8409bc119da49764e065 Mon Sep 17 00:00:00 2001 From: tomer doron Date: Tue, 16 May 2023 15:45:51 -0700 Subject: [PATCH 1/5] improve description of use cases and getting started guides motivation: address feedback frmo core-team changes: * improve description of landing page use cases * improve description of getting started guides * add "cross platform command-line tool" as a landing page use case * change link of use cases to their relevant getting started guides --- .../stylesheets/pages/_getting-started.scss | 16 ++++++------- getting-started/_use-cases.md | 14 ++++++----- index.md | 24 +++++++++++++++---- 3 files changed, 35 insertions(+), 19 deletions(-) diff --git a/assets/stylesheets/pages/_getting-started.scss b/assets/stylesheets/pages/_getting-started.scss index 7177ff513..1aefa1e2a 100644 --- a/assets/stylesheets/pages/_getting-started.scss +++ b/assets/stylesheets/pages/_getting-started.scss @@ -4,7 +4,7 @@ padding-left: 0; display: grid; gap: 1rem; - + .resource { border: 1px solid var(--color-fill-tertiary); padding: 1rem; @@ -18,7 +18,7 @@ grid-column-end: 3; } } - + h3 { padding-top: 0; } @@ -34,7 +34,7 @@ margin-bottom: 1rem; } } - + @media (min-width: $grid-breakpoint) { grid-template-columns: repeat(2, 1fr); } @@ -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); } @@ -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: " ↗" } diff --git a/getting-started/_use-cases.md b/getting-started/_use-cases.md index 7cfe719de..18d15e860 100644 --- a/getting-started/_use-cases.md +++ b/getting-started/_use-cases.md @@ -9,7 +9,7 @@ Looking for a language reference? [The Swift Programming Language (TSPL)](https:

  • Command-line Tool

    - 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.

    Start tutorial @@ -18,7 +18,7 @@ Looking for a language reference? [The Swift Programming Language (TSPL)](https:

  • Library

    - Build a cross-platform library. + Learn how to create cross-platform library for sharing reusable code, or modularize large code-base.

    Start tutorial @@ -27,8 +27,9 @@ Looking for a language reference? [The Swift Programming Language (TSPL)](https:

  • Web Service

    - Use a web framework to build a web service. - Requires macOS or Linux. + Learn how to create a web-service using a web framework. +

    + This guide requires macOS or Linux.

    Start tutorial @@ -37,8 +38,9 @@ Looking for a language reference? [The Swift Programming Language (TSPL)](https:

  • iOS and macOS Application

    - 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. +

    + This guide requires macOS and Xcode.

    Start tutorial diff --git a/index.md b/index.md index 5390e6679..b73ba2844 100644 --- a/index.md +++ b/index.md @@ -72,18 +72,32 @@ Swift is a general-purpose programming language built using a modern approach to

  • Apple platforms

    - 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. +

    + Apple offers a wide variety of frameworks and APIs that make applications developed for these platforms unique and fun. +

    + Learn more +
    • +
  • +

    Command-line

    +

    + Writing Swift code is interactive and fun, the syntax is concise yet expressive. +

    + SwiftArgumentParser and Swift's growing package ecosystem make developing cross-platform command-line tools a breeze.

    - Learn more + Learn more
  • -

    Server

    +

    Server and Networking

    - 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 code is safe by design and produces software that runs lightning-fast. + Swift's small memory footprint, quick startup time, and deterministic performance make it a great choice for server and other networked applications. +

    + SwiftNIO and Swift's dynamic server ecosystem bring joy to developing networked applications.

    - Learn more + Learn more
    • From 50b7fba01ab705a8c4a0eee11f4861a68894ead4 Mon Sep 17 00:00:00 2001 From: Alexander Sandberg Date: Thu, 18 May 2023 09:47:40 +0200 Subject: [PATCH 2/5] expand single last cell in use cases --- assets/stylesheets/pages/_landing.scss | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/assets/stylesheets/pages/_landing.scss b/assets/stylesheets/pages/_landing.scss index e975194fb..9772c2893 100644 --- a/assets/stylesheets/pages/_landing.scss +++ b/assets/stylesheets/pages/_landing.scss @@ -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, From d15abbd358f719e8fd713e12fed586349980fb0e Mon Sep 17 00:00:00 2001 From: tomer doron Date: Thu, 18 May 2023 10:53:22 -0700 Subject: [PATCH 3/5] fixup --- index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.md b/index.md index b73ba2844..3bb046458 100644 --- a/index.md +++ b/index.md @@ -79,9 +79,10 @@ Swift is a general-purpose programming language built using a modern approach to Learn more
  • -

    Command-line

    +

    Cross-platform Command-line

    - Writing Swift code is interactive and fun, the syntax is concise yet expressive. + 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.

    SwiftArgumentParser and Swift's growing package ecosystem make developing cross-platform command-line tools a breeze.

    @@ -91,7 +92,6 @@ Swift is a general-purpose programming language built using a modern approach to

  • Server and Networking

    - Swift code is safe by design and produces software that runs lightning-fast. Swift's small memory footprint, quick startup time, and deterministic performance make it a great choice for server and other networked applications.

    SwiftNIO and Swift's dynamic server ecosystem bring joy to developing networked applications. From 71f241b686178655de32ba65d952755786b6e5dd Mon Sep 17 00:00:00 2001 From: tomer doron Date: Tue, 20 Jun 2023 11:30:41 -0700 Subject: [PATCH 4/5] Update index.md --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 3bb046458..736fd32d9 100644 --- a/index.md +++ b/index.md @@ -97,7 +97,7 @@ Swift is a general-purpose programming language built using a modern approach to SwiftNIO and Swift's dynamic server ecosystem bring joy to developing networked applications.

    - Learn more + Learn more
    • From acc50a96807f738a2987248bcd79f89820a94c3b Mon Sep 17 00:00:00 2001 From: tomer doron Date: Tue, 20 Jun 2023 11:30:49 -0700 Subject: [PATCH 5/5] Update index.md --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 736fd32d9..f847f6f73 100644 --- a/index.md +++ b/index.md @@ -76,7 +76,7 @@ Swift is a general-purpose programming language built using a modern approach to

    Apple offers a wide variety of frameworks and APIs that make applications developed for these platforms unique and fun.

    - Learn more + Learn more

  • Cross-platform Command-line