Skip to content

Add data file with items for "Go Further" section #184

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

Conversation

dempseyatgithub
Copy link
Contributor

@dempseyatgithub dempseyatgithub commented Dec 20, 2022

Add data file with items for Go Further section of Getting Started page.

This PR is against the content-improvements branch.

As discussed in previous workgroup meetings, here is the initial pass at data for items for the Go Further section.

Note that the thumbnail URLs are TBD but included as placeholder entries.

description: "Swift has concurrency features built into the language making it easier to write concurrent code with the assistance of the compiler. This video introduces the async/await mechanism, a key part of Swift Concurrency."
content-type: video
content-url: https://developer.apple.com/videos/play/wwdc2021/10132/
thumbnail-url: TBD
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

considering leaving empty so that the rendering engine can ignore it easily

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've made the TBD a comment so the value is null and easily ignored but still describes the intent to have a value.

@tomerd
Copy link
Contributor

tomerd commented Dec 21, 2022

cc @TimTr to review (or pull the right person) if these are the right resources and topics

@dempseyatgithub
Copy link
Contributor Author

cc @TimTr to review (or pull the right person) if these are the right resources and topics

We had reviewed these items at a workgroup meeting that I don't think @TimTr was able to be at.

To give a little more context, the three videos for concurrency, generics, and regex are good introductions to intermediate Swift topics that represent recent advancements in Swift.

Concurrency and generics are also topics that developers will encounter when working with frameworks like SwiftUI or Vapor.

The blog post about Swift String and UTF-8 is included as an example of an article-based item. It is an excellent article, but may be too advanced for the Go Further section.

Since the Go Further section of the Getting Started page will be dynamically generated from this data, the intent was to have a representative article entry for layout / design purposes, even if this particular item is commented out before the new Getting Started page goes live.

Copy link
Member

@kaishin kaishin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple of suggestions related to the metadata, otherwise looking good!

thumbnail-url: #TBD
release-date: 2022-06-07
- title: "Go Further: Swift Strings Under The Hood"
description: "Swift strings provide a fast, Unicode-compliant way to work with text. In most cases"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the abrupt sentence ending intentional here?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, this may have been a copy/paste victim moving the text from my draft to the data file. Will add a commit.

@dempseyatgithub dempseyatgithub merged commit 849016a into swiftlang:content-improvements Jan 3, 2023
@dempseyatgithub dempseyatgithub deleted the add-go-further-data branch January 21, 2023 16:55
kaishin added a commit that referenced this pull request Sep 7, 2023
* 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]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants