Take the following HTML:
<script src="console.js"></script>
<script src="lodash.js"></script>
<script src="application.js"></script>
Let’s say you want to disable one of the scripts temporarily. So you click your cursor on (or next to) the relevant script tag, and press CMD+/ or CTRL+/.
Expected result:
<script src="console.js"></script>
<script src="lodash.js"></script>
<!-- <script src="application.js"></script> -->
Actual result:
<script src="scripts/safe-console.js"></script>
<script src="scripts/lodash.js"></script>
// <script src="scripts/application.js"></script>
(This happens no matter where on the line you put your cursor – even if you put it right at the beginning of the line, before the indentation.)
The same bug happens with tags, except it uses CSS comment syntax instead, e.g. body{color:blue} becomes /body{color:blue}/.
This bug has existed for as long as I have been using Sublime Text, and it still exists in ST3 (build 3012).
This bug is really annoying, because toggling individual script tags on and off is probably the most common use case for HTML comments when working on large JavaScript codebases (for me, anyway), and HTML’s comment syntax is particularly fiddly to type manually.