So, you think it would make sense to order them in the folder as well.
Might be a good idea, but I think the @Title stuff would get jacked up with
how Yard docs hosts things and works. At the very least, we should reorder
the bullet list.


On Thu, May 8, 2014 at 8:37 AM, brutski <notifications@github.com> wrote:

> In doc/descriptors_document.md:
>
> > +* `href` - The URI of the associated ALPS profile corresponding to the attribute. A relative URI indicates an element
> > +in the current _Resource Descriptor Document_ document.
> > +* `links` - Related links. The YAML keys correspond to a link `rel` attribute and the value with the URI
> > +specified in the link `href` attribute.
> > +* `name` - Used to specify descriptor names which would otherwise have the same, non-unique `id` (YAML key).
> > +* `rt` - The return type of a transition that is an ALPS profile URI. This can be a relative URI indicating it is
> > +associated with secondary profile in the existing resource descriptor or fully-qualified fragment URI associated
> > +with an external ALPS profile. See [ALPS specification][] discussion of `id` for more information.
> > +* `type` - The type of the descriptor. Valid values are `semantic`, `safe`, `unsafe`, or `idempotent`. See
> > +[ALPS specification][] discussion of `type` for more information.
> > +
> > +Other properties are defined in the sections that follow.
> > +
> > +* [Profile Metadata](profile_metadata.md)
> > +* [Data Descriptors](data_descriptors.md)
> > +* [Extensions](extensions.md)
>
> 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
>
> —
> Reply to this email directly or view it on GitHub<https://github.com/mdsol/crichton/pull/152/files#r12435347>
> .
>