Move ports with descriptions to the top of the ports list

[hobgoblina]

Objective

Would be nice to have ports with descriptions appear at the top of the ports list.

I provide descriptions for ports that users are likely to use, but there's a handful of other exposed ports that users are very likely to ignore, which I don't provide descriptions for. This makes it easy to find the useful ports, but they always appear at the bottom of the list... which, for some projects, means that they aren't visible unless you scroll down, which new gitpod users might not realize.

[hobgoblina]

Quickly realized after creating this issue that this happened because I had set the easy-to-ignore ports with the following, which was defined above the useful ports in my .gitpod.yml.

- port: 3000-9229
    onOpen: ignore

Moved that to the bottom of the port definitions and now the ones with descriptions are at the top.

Leaving this open in case the original suggestion still sounds like a good idea to folks.

[akosyakov]

Ports are respecting order from .gitpod.yml by design. It is up to user to add them and reorder. I am not sure there is anything to do, maybe clarify docs?

[loujaybee]

Thanks for raising @necropolina ! :) 👋 You might find this epic about ports useful or interesting: #9262. Also, here is a previous related issue with some context + additional discussion: #7764

Ports are respecting order from .gitpod.yml by design. It is up to user to add them and reorder. I am not sure there is anything to do, maybe clarify docs?

Indeed. However, I do think the current docs (https://www.gitpod.io/docs/configure/workspaces/ports#ports-ordering) do cover this, not sure where else we'd want to add. One thing we could do is do a better job of linting / offering best practices to users, and this could be one. For instance as part of something like: #12893. Maybe we could do this as part of work on inner loop: #7671. For now I will close until we have a more concrete idea of what fix we'd like to see 🙏

[akosyakov]

@loujaybee 👍 for ability to guide. The ports view could allow to change order and automatically apply in .gitpod.yml.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.