Loading
Swift Forums
Swift Website Workgroup - Meeting Notes: 17th January 2023
Swift Website
Workgroup Updates
kaishin
(Reda Lemeden)
March 14, 2023, 8:15pm
1
Attendees
@0xTim
@alexandersandberg
@daveverwer
@kaishin
@kristina
@James_Dempsey
@mishal_shah
@tomerd
Discussions
Merged PRs
#192
,
#184
,
#190
.
@kaishin
recapped the progress on the content improvements branch.
Community Blog Post Review
Reviewed
Blog post proposal: unused code detection with the index store & SwiftSyntax
.
The workgroup agreed to move forward. Good opportunity to introduce IndexStore and SwiftSyntax.
@daveverwer
: take lead on the review process.
SEO Improvements PR
The workgroup decided to merge the PR.
@daveverwer
Content Improvements
@James_Dempsey
pitched linking to TSPL in the Getting Started page.
@daveverwer
asked if it would be a separate section.
@alexandersandberg
pitched linking to the docs and API design guidelines in a separate section.
@alexandersandberg
to add a section the bottom that links to the docs.
@James_Dempsey
to add the link to the book in the Go Further data. The data needs to include a flag to mark the resource as full-width. Specific naming to be discussed in the PR.
@kaishin
to update the CSS to allow expanding any item marked full-width to two columns.
@alexandersandberg
suggested adding arrow to external links.
@kaishin
to make the change in his open PR.
The workgroup agreed to not make any changes to the platform mentions in the Using Swift section.
@daveverwer
suggested spelling out SwiftPM inside the Using Swift section. PR to follow.
@tomerd
suggested workgroup members to follow the guides written by others.
@kaishin
to go over the CLI and library guides.
@kaishin
pitched adding screenshots to the SwiftUI guide.
@0xTim
follow the tutorial and add screenshots.
@kaishin
asked if we can source thumbnails for the Go Further section.
@mishal_shah
pointed out that it might make the section look busy.
The workgroup agreed to give thumbnails a try before making a decision.
@kaishin
to add thumbnails for videos. Will also explore icons if time allows.
The workgroup agreed to not display publication dates in the Go Further section.
The workgroup has agreed to target end of January to prepare the
content-improvements
branch for external input.
Missing items are the vapor guide and the install page.
@0xTim
to open a PR with the Vapor guide.
@tomerd
@mishal_shah
to get the install page ready.
Open PRs
@mishal_shah
looked into
#131
and mentioned that there were no security patches between 3.x and 5.x. The library is used in one section of the website to toggle expandable sections.
The workgroup agreed to close the PR for now without merging.
@mishal_shah
to open a new issue to remove the dependency and explore replacements.
Process
@kaishin
pitched using the same forums thread for the agenda.
@tomerd
volunteered to send a reminder on Slack.
@kaishin
suggested to automate the reminder.
@0xTim
to look into adding the bi-weekly reminder to Slack.
1 Like