Alphabetize prop names in documentation about carbon-components-svelte HOT 5 CLOSED

I'm opposed to this. Props are purposefully listed with the most relevant/important. In the docs, reactive vars are listed first.

Generally, props should be sorted by importance, relevance, then grouped by similarity.

from carbon-components-svelte.

For example - yes, it's easier to initially find a prop in an alphabetized list, but it's inefficient beyond that.

A prop like hideLabel naturally follows labelText. If alphabetized, hideLabel would appear before labelText.

Props like invalidText and warnText should also be close in proximity.

from carbon-components-svelte.

I alphabetised them in code to make the editing experience easier. This is something I'm gonna want to do before doing the tasks for #1629. Is there a way we can make this an initial step for #1629 without it becoming too painful?

from carbon-components-svelte.

@metonym fair enough, the rationale is sound. Seeing most-used props first does provide good quality of life to users, myself included. I don't see a way to ensure this ordering via linting or docs generation, but that's ok.

from carbon-components-svelte.

I added a "Prop ordering" rule in #1621 so that this is captured somewhere. We can continue to discuss ordering in that proposal.

from carbon-components-svelte.