wasp-lang / wasp

The fastest way to develop full-stack web apps with React & Node.js.
https://wasp-lang.dev
MIT License
13.63k stars 1.18k forks source link

Explain launch vs deploy better in Fly deployment docs | Add TLDR #1582

Open matijaSos opened 11 months ago

matijaSos commented 11 months ago

When I came back to my Wasp app after a while, I forgot the exact command to re-deploy and it took me a while to locate it, had to read through the bunch of the docs.

Maybe we can add some TLDR/cheatsheet on the top? Also explain better that launch should be used only once, and then you should use wasp deploy fly deploy

Martinsos commented 11 months ago

This is related to https://github.com/wasp-lang/wasp/issues/1345 .

I had similar experience, found docs to bee too verbose while on the other hand not explaining some concepts well enough.

I think the solution is to:

  1. Have a summary/TDLR at the top.
  2. Write about all the options in more details, in a more structured manner.