Add TSPL Go Further section and resource thumbnails #227

kaishin · 2023-01-31T11:50:50Z

Motivation:

These changes were discussed during the last workgroup meeting.

Modifications:

Added the featured TSPL section, alongside a new flag to make any resource span 2 columns.
Added thumbnails and a placeholder image for sections.
Changed the hierarchy of border colors to make the content stand out more vs. the chrome.

Result:

alexandersandberg

Nice job! I actually like the thumbnails, but it kinda makes me want to add thumbnails to the "Using Swift" tutorials as well as the Go Further section is stealing the attention from them a bit at the moment.

_data/go_further.yml

kaishin · 2023-01-31T12:44:04Z

Nice job! I actually like the thumbnails, but it kinda makes me want to add thumbnails to the "Using Swift" tutorials as well as the Go Further section is stealing the attention from them a bit at the moment.

That's a good point. I noticed the same as well. Let's explore adding thumbnails for the guides.

kaishin · 2023-01-31T12:45:20Z

_data/go_further.yml

+- title: "The Swift Programming Language Book"
+  description: "The authoritative reference for Swift,
+offering a guided tour, a comprehensive guide, and a formal reference of the language."
+  content_type: book
+  content_url: https://docs.swift.org/swift-book


@dempseyatgithub This data is placeholder so feel free to comment here and I'll update it. There is probably no need to have a separate PR.

Thanks for adding this placeholder @kaishin. Is the template set up to process markdown in the title/description? The title of the book in the description should be in italics.

title: A Swift Tour

description: "The Swift Programming Language , the authoritative reference for Swift, begins with a tour of the language. The tour gives you an introduction to the fundamental features, concepts, and syntax of Swift. The remainder of the book explains each topic in greater detail."

content_url: https://docs.swift.org/swift-book/GuidedTour/GuidedTour.html

Thank you! Updated.

Is the template set up to process markdown in the title/description?

It wasn't but I pushed a change that takes care of that.

kaishin · 2023-01-31T12:50:33Z

_data/go_further.yml

 - title: "Swift Generics"
  description: "In Swift, generics are a fundamental way to write abstract code. This video walks through the basics of Swift Generics and introducing generics into your code."
  content_type: video
-  content_url: https://developer.apple.com/videos/play/wwdc2021/10132/
-  thumbnail_url: #TBD
+  content_url: https://developer.apple.com/videos/play/wwdc2022/110352/


@dempseyatgithub I updated the URL here in what I assume was a typo, but I am not sure if this is the right video. Please let me know.

kaishin · 2023-01-31T12:51:38Z

assets/stylesheets/pages/_getting-started.scss

@@ -1,24 +1,42 @@

-.go-further-list{
+.go-further-list {
+  $grid-breakpoint: 1000px;


Using Sass variable here since CSS-native variables don't seem to be supported in media queries.

Co-authored-by: Alexander Sandberg <[email protected]>

* Update landing page content (#127) * First pass at the new Getting Started page (#174) * Adding Getting Started tutorial for SwiftUI / iOS 16. (#185) * Add data file with items for "Go Further" section (#184) * Add cli and library getting started guides (#192) * Getting started tweaks (#208) * Rename Markdown files to have an `.md` extension. (#209) * Fix typo (#214) * Update getting started page layout (#204) * Add documentation information to Getting Started (#226) * Add Vapor Getting Started guide (#229) * Update content-improvments branch per feedback (#244) * Tweak SwiftUI tutorial (#240) * Add TSPL Go Further section and resource thumbnails (#227) * Improve 'Why Swift?' section on landing page (#252) * Replace Go Further item for advanced String Under The Hood blog post with item for Structures and Classes chapter in TSPL (#254) * Update landing page layout (#267) * Link to developer.apple.com from apple use case (#291) * Smaller landing page changes on content improvements branch (#294) * Update Go Further section (#300) * Update icons and placeholder image (#301) * Improve description of use cases and getting started guides (#304) * POC: Feature random code snippet on landing page (#303) * New “Swift is…” and About page copy (#336) * Move link to A Swift Tour to the Use Cases section (#329) * Add consistent download section to start and end of each guide (#351) * Add a new install page, update the download page, and move release yml files into one file. (#310) * Update navigation for install page (#355) * Update cli and library getting started guides (#357) * Content improvement guide updates (#373) * Add value and reference types article (#377) * Add some showcase snippets (#371) * Resolve issue with Red Hat download links (#379) * Add Info about Scoop for Windows install page (#382) --------- Co-authored-by: Alexander Sandberg <[email protected]> Co-authored-by: Paul Hudson <[email protected]> Co-authored-by: James Dempsey <[email protected]> Co-authored-by: tomer doron <[email protected]> Co-authored-by: Dave Verwer <[email protected]> Co-authored-by: Tim Condon <[email protected]> Co-authored-by: Max Desiatov <[email protected]> Co-authored-by: Mishal Shah <[email protected]> Co-authored-by: AG <[email protected]> Co-authored-by: Ted Kremenek <[email protected]>

kaishin requested review from 0xTim, alexandersandberg, daveverwer, dempseyatgithub, krstnfx, mschinis, shahmishal, TimTr, twostraws and tomerd as code owners January 31, 2023 11:50

alexandersandberg approved these changes Jan 31, 2023

View reviewed changes

_data/go_further.yml Outdated Show resolved Hide resolved

kaishin commented Jan 31, 2023

View reviewed changes

shahmishal approved these changes Feb 13, 2023

View reviewed changes

kaishin and others added 3 commits February 28, 2023 19:30

Add TSPL section and resource thumbnails

9440575

Fix typo

fa2c322

Co-authored-by: Alexander Sandberg <[email protected]>

Update TSPL section description

761cd8f

kaishin force-pushed the content-improvements branch from 7f92987 to 761cd8f Compare February 28, 2023 18:31

kaishin merged commit cb3e51c into swiftlang:content-improvements Feb 28, 2023

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add TSPL Go Further section and resource thumbnails #227

Add TSPL Go Further section and resource thumbnails #227

Uh oh!

kaishin commented Jan 31, 2023

Uh oh!

alexandersandberg left a comment

Uh oh!

Uh oh!

kaishin commented Jan 31, 2023 •

edited

Loading

Uh oh!

kaishin Jan 31, 2023

Uh oh!

dempseyatgithub Jan 31, 2023

Uh oh!

kaishin Jan 31, 2023

Uh oh!

kaishin Jan 31, 2023

Uh oh!

kaishin Jan 31, 2023

Uh oh!

Uh oh!

Add TSPL Go Further section and resource thumbnails #227

Add TSPL Go Further section and resource thumbnails #227

Uh oh!

Conversation

kaishin commented Jan 31, 2023

Motivation:

Modifications:

Result:

Uh oh!

alexandersandberg left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

kaishin commented Jan 31, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

kaishin Jan 31, 2023

Choose a reason for hiding this comment

Uh oh!

dempseyatgithub Jan 31, 2023

Choose a reason for hiding this comment

Uh oh!

kaishin Jan 31, 2023

Choose a reason for hiding this comment

Uh oh!

kaishin Jan 31, 2023

Choose a reason for hiding this comment

Uh oh!

kaishin Jan 31, 2023

Choose a reason for hiding this comment

Uh oh!

Uh oh!

kaishin commented Jan 31, 2023 •

edited

Loading