The development documents only cover a small portion of the ‘setting up a development environment’. However these docs miss the most important part: Setting up the IDE (visual studio code) to properly run, with breakpoints. Simply providing an example launch.json would probably suffice.
For example: The dev container route describes all the requirements to set up ‘dev contianer’ on all 3 major operating systems. It even claims that VSCode is required. However the last set of instructions just get you a container running in docker. Additional setup is needed to get Home Assistant running with your changes.
I stumbled upon this thread with a lengthy vscode setup process for VSCode & Dev Container. I don’t know if this is correct however it worked for me. Either way, this should be included in the dev docs by someone “in the know” with proper corrections.