in-toto / specification

Specification and other related documents.
https://in-toto.io
MIT License
38 stars 25 forks source link

add toc to spec #54

Closed kevholmes closed 2 years ago

kevholmes commented 2 years ago

Resolve issue https://github.com/in-toto/docs/issues/3

As I was working my way through the spec I also cleaned up a number of basic markdown linting errors that popped up along the way.

kevholmes commented 2 years ago

Unable to add Reviewers, tagging maintainers for visiblity @SantiagoTorres @adityasaky @lukpueh.

adityasaky commented 2 years ago

This is neat! Let me see if this also applies to the PDF. Also, did you use an automated plugin or something to generate it? Just so we can keep it updated as we go along.

adityasaky commented 2 years ago

Hmm, looks like pandoc struggles with deeply nested lists, or rather, it converts to an intermediate latex form that struggles?

SantiagoTorres commented 2 years ago

Hmm, I think we can make this happen for now and figure out the pandoc bits afterwards...

adityasaky commented 2 years ago

I think I've got it working with an alternative pdf engine. Let me push to this PR and we should be good to go.

adityasaky commented 2 years ago

Thanks again, @kevholmes!