-
-
Notifications
You must be signed in to change notification settings - Fork 330
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
Recommend Swiftly as install method on Linux #925
Conversation
docs/install/linux.md
Outdated
@@ -1,6 +1,6 @@ | |||
# Install on Linux | |||
|
|||
To use Vapor, you will need Swift 5.6 or greater. This can be installed using the toolchains available on [Swift.org](https://swift.org/download/) | |||
To use Vapor, you will need Swift 5.6 or greater. This can be installed using the CLI tool [Swiftly](https://swift-server.github.io/swiftly/) provided by the Swift Server Workgroup (reccommended), or the toolchains available on [Swift.org](https://swift.org/download/). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We now require 5.7, not 5.6
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, thank you! I thought I knew that but wasn't able to retrieve this information, can you please point me? I have:
- corrected the Swift version.
- corrected a typo on this file
- corrected all version on the table about linux, added windows that supports Swift 5.7, as reported on swift.org and Fedora website.
docs/deploy/digital-ocean.md
Outdated
!!! note | ||
Swift's [Using Downloads](https://swift.org/download/#using-downloads) guide includes information on how to verify downloads using PGP signatures. | ||
Fetching the latest stable Swift release... | ||
Installing Swift 5.8.1 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The current latest release is 5.9.1, not 5.8.1
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
corrected this, thanks. It was copy pasted from the Swiftly Github README file
docs/install/linux.md
Outdated
$ swiftly install latest | ||
|
||
Fetching the latest stable Swift release... | ||
Installing Swift 5.8.1 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
5.9.1 again
docs/basics/routing.it.md
Outdated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you split this out into a separate PR? Thanks!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Of course. I did it by mistake.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It should be ok now 👍
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
One change around platform support then good to go!
docs/install/linux.md
Outdated
|Fedora|>= 35|>= 5.7| | ||
|CentOS|7|>= 5.7| | ||
|Amazon Linux|2|>= 5.7| | ||
|Windows|10|>= 5.7| |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We don't support Windows
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Oooooops!
docs/install/linux.md
Outdated
|
||
## Supported Distributions and Versions | ||
|
||
Vapor supports the same versions of Linux distributions that Swift 5.6 or newer versions supports. | ||
Vapor supports the same versions of Linux distributions that Swift 5.7 or newer versions supports. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think here we can tweak this to remove the note and table and just link to https://www.swift.org/platform-support/ instead
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Well, this information is doomed to be always not up to date, you're right... What about like this?
## Supported Distributions and Versions
Vapor supports the same versions of Linux distributions that Swift 5.7
or newer versions supports. Please refer to the
[official support page](https://www.swift.org/platform-support/)
in order to find updated information about which operating systems
are officially supported.
Linux distributions not officially supported may also run Swift
by compiling the source code, but Vapor cannot prove stability.
Learn more about compiling Swift from
the [Swift repo](https://github.com/apple/swift#getting-started).
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yep that works great
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks!
update cn doc for PR #925 @Jinxiansen
Any place we say to install Swift on Linux (deploy docs, getting started etc) should use Swiftly instead of directing people to download them from the install pages