Beyond alphabetic ordering or methods and properties

[brian428]

It looks like the API docs always list the properties and methods in alphabetical order. It would be nice to have a configuration option to change this so things are listed by access modifier (static public/static protected/static private/public/protected/private).

Thoughts?

[FlippieCoetser]

Yes, Please!

[sebastian-lenz]

The entries of the documentation are currently grouped by kind and then sorted by static state and name. Of course we can add new ways of grouping and sorting.

[brian428]

Yeah, this obviously isn't a critical issue or anything. We do have the option to filter to see only public, or public and protected as well. I just thought it would be helpful to be able to see all the elements, but organize them a bit more.

Thanks again for the great work on Typedoc. We all know it's hard to overstate how useful good API docs are!

[jrieken]

I have a single d.ts file and I would prefer the sorting to be the order in which symbols are defined in source.

[kristiyanP]

I wonder if this issue got any follow up?
Is it now possible to sort the entries?
Would be much more readable if the entries were sorted by first not optionals and then optionals.
Any insight on how to achieve this?
Thanks

[Gerrit0]

This could be achieved by modifying the default theme to sort before rendering. I'm not aware of any implementation, but it shouldn't be that difficult to do.

[kristiyanP]

Thank you, I will look into it.
I still do believe that this should be the default behaviour... When reading a public API you are most interested in what is required and not what is optional.

[kristiyanP]

For example:
https://typedoc.org/api/interfaces/typeparametercontainer.html#flags

The fact that flags, id, kind,name,originalName parameters are required is not clear at all.
A well defined API would first give priority to the required fields and then the optionals.
Maybe also group them in two categories.

[azinit]

Still actual!)

[jankuca]

It would be great to have the option to preserve the original method/property order.