[Docs] flytectl demo vs flytectl sandbox

[shekhar-kotekar]

Description

As of now there are 2 ways to create a fully standalone minimal environment for running Flyte. One is using flytectl demo start command and other is with flytectl sandbox start command. Document for demo is here and document for sandbox is here.

Having these 2 different ways for the same thing is confusing for a new comer because of multiple reasons:

1. They don't know which is better or preferred way
2. Which is used by Flyte team internally?
3. Is any approach better or worse than the other?
4. Is there any plan to deprecate one of them? If yes then what's the plan / dates, etc?

This hard to find document says that demo is lighter / better but there isn't any action or ticket to manage this document hence creating this ticket. Hopefully it is not a duplicate issue.

Are you sure this issue hasn't been raised already?

• Yes

Have you read the Code of Conduct?

• Yes

[welcome]

Thank you for opening your first issue here! 🛠

[pingsutw]

@wild-endeavor @eapolinario, should we deprecate the sandbox?

[wild-endeavor]

we should update flytectl first, and then just make demo an alias of sandbox.

[davidmirror-ops]

I think this is done?

[davidmirror-ops]

I think we should now remove references to flytectl sandbox? https://docs.flyte.org/en/latest/flytectl/sandbox.html

[RaghavMangla]

Hi! I would like to work on this issue

[davidmirror-ops]

@RaghavMangla thanks for your willingness to contribute. Considering you already have 6 issues assigned to you, and following the principle of "first come first serve" we'd like to encourage you to send PRs for the issues where you are already an assignee and then, if no one has taken this one, we can assign to you. Thanks in advance :)

[shinigami-777]

Hi @davidmirror-ops I would like to work on this if not taken. Should the entire section under flytectl sandbox be removed from https://docs.flyte.org/en/latest/api/flytectl/sandbox.html ?

[davidmirror-ops]

@shinigami-777 done! Please let us know soon any questions you may have. Thank you