I agree. I was going to propose to name documents in order. Like:
And it is like top-to-bottom reading list.
0_descriptors_document.md
1_profile_metadata.md
2_data_descriptors.md
3_transition_descriptors.md
4_resource_transitions.md
5_extensions.md
6_media_types.md
7_protocol_descriptors.md
8_routes_descriptors.md