Wrapped template fragments
When developing websites, the dev team at Ideas On Purpose has found it very useful to wrap template fragments in named HTML comments. During development and debugging, these waypoints reveal the exact files and structure of how how the page was assembled.
Most files look something like this:
<?php // a bunch of logic which populates the $pages variable ?> <!-- START template-parts/components/pagination.php --> <nav class="pagination"> <?= implode("\n", $pages) ?> </nav> <!-- END template-parts/components/pagination.php -->
A Visual Studio Code snippet
Generally speaking, I will crawl across broken glass to keep from writing the same thing twice. So there was no way I was going to mentally survive entering snippets again and again, twice for every file. The attached snippet will wrap any VS Code selection inside a pair of HTML comments which include ther shortened path to the file.