[OSPO Book] Table of contents

[cornelius]

The table of content contains the list of chapters and some notes about their content. It would be good to link the entries in the table of content to the actual chapters.

I'm not sure how to do this with hugo in a way that it shows up on the generated site correctly. If you have a hint for me how to do it, I can also come up with a pull request.

For the chapters which aren't completed yet there is no content on the generated site yet. So it would be good to add a note that it is work in progress instead of the link.

[alice-sowerby]

I am repurposing this issue to represent the Table of Contents (TOC) on the Project Board as the TOC will need to be updated regularly.

[alice-sowerby]

I think it would also be worth including "Chapter X" at the start of each chapter, as it's unclear in the live book which chapter is which (and the chapters are numbered in the TOC). The alternative would be to remove chapter numbers altogether, but I think that is less useful.

[koozz]

I thought it was just the page link + the anchor (just like what you get on hovering a heading in the GitHub markdown docs):

02-chapter.md#supply-chain-and-open-source is the link according to GitHub, but Hugo will render it as 02-chapter/#supply-chain-and-open-source.

[anajsana]

Who owns this task and is working on it?

[koozz]

Who owns this task and is working on it?

I will have a look at this.