Branch: refs/heads/claude/cool-tesla-6a1n0j Home: https://github.com/xwiki/xwiki-dev-llm Commit: 9ef09dc7a93ed6fabd9937a81272538c7f515118 https://github.com/xwiki/xwiki-dev-llm/commit/9ef09dc7a93ed6fabd9937a8127253... Author: Vincent Massol <[email protected]> Date: 2026-08-25 (Tue, 25 Aug 2026) Changed paths: M xwiki/okf/conventions/code-comments.md M xwiki/okf/conventions/code-style.md Log Message: ----------- [Misc] Record two comment conventions enforced in review * An empty catch needs a "// TODO:" asking to log a warning or to change the logic, not just a rationale comment: a catch that neither rethrows nor logs is a bug to fix later, not a decision to document. * A Javadoc comment is always multi-line, never the one-line form, and a file still using the one-line form gets converted when it is touched. Neither rule is on the dev wiki CodeStyle page. Co-Authored-By: Vincent Massol <[email protected]> To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications