C++ Logo

std-proposals

Advanced search

Re: [std-proposals] Standardizing doc comments

From: Sebastian Wittmeier <wittmeier_at_[hidden]>
Date: Sat, 22 Mar 2025 15:25:52 +0100
If you want to add a hype topic:   One current issue is AI generated or AI supported code and its lack of stability for multiple AI passes.   A LLM could refactor everything in a project wrongly for an actual one-line change.   It could lose the requirements and the tested code and the design decisions.   Structured source code comments could help with those issues a bit.     -----Ursprüngliche Nachricht----- Von:Jan Schultke via Std-Proposals <std-proposals_at_[hidden]> Gesendet:Fr 21.03.2025 08:00 Betreff:[std-proposals] Standardizing doc comments An:C++ Proposals <std-proposals_at_[hidden]>; CC:Jan Schultke <janschultke_at_[hidden]>; Has there been any attempt to standardize doc comments for C++, similar to Javadoc (https://download.java.net/java/early_access/loom/docs/specs/javadoc/doc-comment-spec.html)? Doxygen-style comments have been existing practice for a long time, and many tools support them to some extent. I could improve UX if we had a standard syntax and a set of standard tags for such comments. -- Std-Proposals mailing list Std-Proposals_at_[hidden] https://lists.isocpp.org/mailman/listinfo.cgi/std-proposals

Received on 2025-03-22 14:31:16