Proper documentation for folder.yaml

[sebszocinski]

Just a quick one... can we get some proper documentation for the folder.yaml file in terms of what options we have for controlling ordering and sorting as well as columns and if any of this can be extended via an addon?

For eg I want to order by number (I worked that out by trial and error) but I also want to set it to default sorting descending, so highest number first... something like order: number-descending would work a treat.

[sebszocinski]

I've also worked out that sort_dir exists but it breaks number ordering.. ie if you have sort_dir:desc it will be default list them in descending order, but if you try to then reorder them after you hit save it swaps the order over... so an item with position 12 becomes 1, 11 becomes 2 and so on...

See: https://github.com/statamic/v2-hub/issues/1210

[bluetidepro]

Bump - would also like to see this in the docs! :)