Since the permalink thing (and some of these other issues) are ReSpec
features, and not part of our specs per se, can I ask that people file bugs
via github (or submit pull requests - that's even better)? ReSpec is used
by A LOT of people, so any changes need to be carefully vetted by that
community.
On Thu, Dec 4, 2014 at 10:37 AM, Joseph Scheuhammer <clown@alum.mit.edu>
wrote:
> Hi Matt,
>
> Regarding your first two issues:
>
> Issues:
>>
>> 1. Section heading levels are not correct. Every section, regardless of
>> its level, has h2. So for example, sections5, 5.1, and 5.1.1 are all H2
>> instead of H2, H3, and H4.
>>
>
> I think this depends on which text you are looking at. If you are looking
> at the input to ReSpec, yes, all headings are the same level. That's
> because ReSpec calculates the heading levels and updates as appropriate.
> Thus, if you look at the document after ReSpec is finished, then the
> heading levels are nested as you recommend. Similarly, if you look at
> snapshot output using ReSpec's "save" function.
>
>>
>> 2. the permalinks are included inside the heading tags. It would improve
>> readability if they were not a child of the heading.
>>
>
> That says what the permalink should *not* be. What should it be? Prior to
> moving to ReSpec, the permalink was the first paragraph after the heading.
> Would that work better? See, for example:
> http://www.w3.org/TR/2014/REC-wai-aria-20140320/complete#roles
>
> Hope that helps.
>
>
> --
> ;;;;joseph.
>
> 'Array(16).join("wat" - 1) + " Batman!"'
> - G. Bernhardt -
>
>
>
--
Shane McCarron
Managing Director, Applied Testing and Technology, Inc.
Received on Thursday, 4 December 2014 16:56:02 UTC