Add Coding Standards and AI Tool Advice.#185
Open
zzcgumn wants to merge 5 commits into
Open
Conversation
…tories Bazel constructs a minimal PATH that excludes Homebrew on macOS, causing the doxygen availability check to fail even when doxygen is installed. Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds project documentation describing DDS coding standards and practical guidance for using coding agents/tools, while also tidying GitHub/Git workflow instructions and improving the Bazel Doxygen doc generation rule’s PATH handling.
Changes:
- Add
docs/coding_standards_and_ai_advice.mdwith coding standards links and tooling recommendations. - Update the
//:doxygen_docsgenrule to adjust PATH based on host OS before invokingdoxygen/zip. - Simplify GitHub/Git workflow instructions to prefer CLI-based workflows over MCP-specific guidance.
Reviewed changes
Copilot reviewed 4 out of 5 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| MODULE.bazel.lock | Updates Bazel module lock digest for Emscripten deps. |
| docs/coding_standards_and_ai_advice.md | New documentation on coding standards + AI/tooling guidance; includes docs build instructions. |
| BUILD.bazel | Improves doxygen_docs genrule robustness by setting PATH per OS. |
| .github/instructions/github.instructions.md | Removes MCP-server-specific guidance; updates contributor workflow tooling section. |
| .github/instructions/git.instructions.md | Updates PR-opening step to reference CLI workflow. |
Comment on lines
+34
to
38
| Use the github command line interface to: | ||
| - Create branches | ||
| - Commit and push changes | ||
| - Open pull requests | ||
| - Check PR status |
| 3. **Commit** with a clear message. | ||
| 4. **Push** the branch. | ||
| 5. **Open a PR** via the `github` MCP server (see `github.instructions.md`). | ||
| 5. **Open a PR** via the `github` command line interface. |
Comment on lines
+40
to
+46
| Code documentation for DDS3 is generated with Doxygen, which extracts formatted comments from the source code. Run the following command to generate the local documentation: | ||
|
|
||
| ``` | ||
| bazelisk build //:doxygen_docs | ||
| ``` | ||
|
|
||
| The generated HTML pages are available under `doxygen_output/html/`. Open `doxygen_output/html/pages.html` to read the documentation. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a document about coding standards and AI tools. It is based on my experience from modernising the code base in the first quarter of 2026. I have also tidied up GitHub instructions, which define the coding standards and fixed the command to extract the documentation from Doxygen style comments.