Your Code Comments Now Have a Second Audience
I was checking what tools were available to GitHub Copilot from the MCP server I had just built. It showed a list. Each entry had a tool name at the top — the actual function name exported as an MCP tool. Next to it, in slightly smaller text, a description. Wait, I hadn't written any descriptions. Not in the MCP configuration, not in any separate documentation file. I had written nothing that I thought of as a description. Then I realized. That smaller text was my docstring. The comment I wrote at the top of the function — the one explaining what the procedure does, what arguments it takes, what it returns — was sitting right there, being shown to Copilot as the tool's documentation. The AI was reading my code comments. Not inferring from them. Using them directly, word for word, to understand what the tool does and how to use it. That was the moment I realized something had quietly shifted about what a code comment actually is. The Old ...