Skip to content

Documentation - Copilot instructions for OCCT development#589

Merged
dpasukhi merged 3 commits intoOpen-Cascade-SAS:IRfrom
dpasukhi:code-agents-instr
Jul 6, 2025
Merged

Documentation - Copilot instructions for OCCT development#589
dpasukhi merged 3 commits intoOpen-Cascade-SAS:IRfrom
dpasukhi:code-agents-instr

Conversation

@dpasukhi
Copy link
Copy Markdown
Member

@dpasukhi dpasukhi commented Jul 6, 2025

Added copilot-instructions.md
Ignore other agents instruction for git history

Added copilot-instructions.md
Ignore other agents instruction for git history
@dpasukhi dpasukhi added this to the Release 7.9.2 milestone Jul 6, 2025
@dpasukhi dpasukhi requested a review from Copilot July 6, 2025 08:33
@dpasukhi dpasukhi added the 1. Documentation Improvements or additions to documentation label Jul 6, 2025

This comment was marked as outdated.

@dpasukhi dpasukhi requested a review from Copilot July 6, 2025 12:10

This comment was marked as outdated.

@dpasukhi dpasukhi requested a review from Copilot July 6, 2025 12:25
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds a comprehensive Copilot instructions document for OCCT C++17+ development, covering memory management, coding conventions, workflows, and build/test guidance.

  • Introduces core directives for OCCT coding patterns.
  • Details project structure, naming conventions, and modern C++ best practices.
  • Provides step-by-step workflows for adding classes, tests, and building.
Comments suppressed due to low confidence (2)

.github/copilot-instructions.md:1

  • Consider adding a table of contents at the top of this extensive document to help readers quickly navigate between sections.
# OCCT Copilot Instructions

.github/copilot-instructions.md:193

  • [nitpick] For consistency, you might add the Windows equivalent for this quick build step (e.g., using md build && cd build) alongside the Unix command.
  mkdir -p build && cd build

Comment on lines +106 to +111
- `auto`
- Range-based `for` loops
- Structured bindings: `for (const auto& [key, value] : aMap)`
- `std::optional` for optional return values where appropriate.
- `if constexpr` for compile-time conditions.

Copy link

Copilot AI Jul 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] The list of modern C++ features is long; consider grouping related items under subheadings or turning this into a two-column table to improve scanability.

Suggested change
- `auto`
- Range-based `for` loops
- Structured bindings: `for (const auto& [key, value] : aMap)`
- `std::optional` for optional return values where appropriate.
- `if constexpr` for compile-time conditions.
| Feature | Description/Example |
| ------------------------ | ------------------------------------------------------- |
| `auto` | Simplifies type declarations. |
| Range-based `for` loops | Cleaner iteration over containers. |
| Structured bindings | `for (const auto& [key, value] : aMap)` for maps, etc. |
| `std::optional` | Use for optional return values where appropriate. |
| `if constexpr` | Enables compile-time conditions. |

Copilot uses AI. Check for mistakes.
@dpasukhi dpasukhi merged commit bdbd5ac into Open-Cascade-SAS:IR Jul 6, 2025
13 checks passed
@dpasukhi dpasukhi deleted the code-agents-instr branch July 6, 2025 12:27
@github-project-automation github-project-automation bot moved this from Todo to Done in Maintenance Jul 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1. Documentation Improvements or additions to documentation

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants