Tables of contents are tricky. My publishing logic is rather flexible in how I use them, so I used to put them into the margins of longer articles[1] and sometimes even shorter ones[2] although I wasn't great at always remembering to do it[3].
But the problem for me is that good headlines, that give a fair summary of the section they are for, make for really wide tables of contents which don't fit neatly into the margins[4], so sometimes the table of content has to occupy space in the main section[5] which seems to me like it distracts a bit from the actual content.
But the problem for me is that good headlines, that give a fair summary of the section they are for, make for really wide tables of contents which don't fit neatly into the margins[4], so sometimes the table of content has to occupy space in the main section[5] which seems to me like it distracts a bit from the actual content.
[1]: https://two-wrongs.com/markov-chains-for-queueing-systems.ht...
[2]: https://two-wrongs.com/verifiable-software-development-estim...
[3]: https://two-wrongs.com/event-sourcing-and-microservices-unix...
[4]: https://two-wrongs.com/word-embeddings-in-perl.html
[5]: https://two-wrongs.com/what-is-probability.html