[docs] Add comparison page #3756
Conversation
| * **With SkyPilot, a single sky launch takes care of everything.** Behind the scenes, SkyPilot provisions pods, installs all required dependencies, executes the job, returns logs and provides SSH and VSCode access to debug. | ||
|
|
||
|
|
||
| Simpler YAMLs |
There was a problem hiding this comment.
Just thinking out loud, do we like this better or something like "Simpler interface and faster developer speed" (the latter is more directly a benefit)?
docs/source/reference/comparison.rst
Outdated
| Comparing SkyPilot with other systems | ||
| ===================================== | ||
|
|
||
| We are often asked "How does SkyPilot compare with XYZ?". Providing an unbiased and up-to date answer for such questions is not easy, especially when the differences may be qualitative. |
There was a problem hiding this comment.
Kind of feel this para is a bit odd. Seems messages aren't lost if left out. Wdyt? Cc @Michaelvll for a look too.
There was a problem hiding this comment.
I added it because comparisons can be sensitive for the authors of other systems, especially if we do not present their strengths. I think this should stay in
There was a problem hiding this comment.
We can keep this, but may be good to rephrase a bit of the sentence. Some reference for how other library starts the comparison:
Because of this flexibility, Terraform can be used to solve many different problems. This means there are a number of existing tools that overlap with the capabilities of Terraform. We compare Terraform to a number of these tools, but it should be noted that Terraform is not mutually exclusive with other systems. It can be used to manage a single application, or the entire datacenter.
Because of this broad array of supported scenarios, there are many tools that overlap with Pulumi’s capabilities. Many of these are complementary and can be used together, whereas some are “either or” decisions.
There was a problem hiding this comment.
Reworded the paragraph. wdyt?
There was a problem hiding this comment.
Thanks for adding this page @romilbhardwaj! This will be very important for a potential k8s user.
| SkyPilot vs Vanilla Kubernetes | ||
| ------------------------------ | ||
|
|
||
| Kubernetes is a powerful system for managing containerized applications. :ref:`Using SkyPilot to access your Kubernetes cluster <kubernetes-overview>` boosts developer productivity and allows you to scale your infra beyond a single Kubernetes cluster. |
There was a problem hiding this comment.
Can we show a architecture diagram for showing how SkyPilot relates to kubernetes clusters? For example, a user interacts with SkyPilot and SkyPilot sends the requests to underlying Kubernetes.
There was a problem hiding this comment.
Good idea - added an architecture figure. wdyt?
|
|
||
| </div> | ||
| </div> | ||
|
|
There was a problem hiding this comment.
Just thinking out loud, not sure if we can think of other value adds on this page, or if we can go a bit deeper for the points we mentioned below, like what is the quantitative benefits GPU availability and Costs can provide. The current points feel a bit weak.
There was a problem hiding this comment.
Hmm we had some numbers in the earlier commits but removed them in this comment
There was a problem hiding this comment.
I see! Let's skip the numbers for now then.
| SkyPilot vs Vanilla Kubernetes | ||
| ------------------------------ | ||
|
|
||
| Kubernetes is a powerful system for managing containerized applications. :ref:`Using SkyPilot to access your Kubernetes cluster <kubernetes-overview>` boosts developer productivity and allows you to scale your infra beyond a single Kubernetes cluster. |
|
Thanks for the reviews! Merging now. |
Adds a page comparing SkyPilot to other systems.
TODO: