Skip to content

documentation update#3

Merged
ninjaro merged 3 commits into
masterfrom
docs
Jul 16, 2025
Merged

documentation update#3
ninjaro merged 3 commits into
masterfrom
docs

Conversation

@ninjaro
Copy link
Copy Markdown
Owner

@ninjaro ninjaro commented Jul 16, 2025

No description provided.

@ninjaro ninjaro requested a review from Copilot July 16, 2025 20:51
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 updates documentation and enhances the codebase with improved documentation, repository migration, and test refinements. The changes focus on making the project more maintainable and accessible through better documentation and cleaner test cases.

  • Updated README with comprehensive syntax guide and examples
  • Added extensive code documentation with detailed comments and function descriptions
  • Migrated repository references from YaRiabtsev to ninjaro across all badges and links

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
readme.md Complete overhaul with expanded syntax guide, examples, and updated repository references
include/reader.hpp Added comprehensive documentation for tokenizer functions and structures
include/grouper.hpp Enhanced documentation for AST parsing and grouping functionality
include/expression.hpp Added detailed documentation for expression parsing components
include/ast.hpp Improved documentation for AST node structures and memory management
tests/arithmetic_tests.cpp Simplified test inputs by removing semicolons and updated assertions
.github/workflows/tests.yml Added path filters to optimize CI execution
.github/workflows/html.yml Added Codacy integration and path filters

Comment thread include/ast.hpp
std::ostream& os, const std::string& prefix, bool is_last, bool full
) const override;
const position& get_start() const override;
[[nodiscard]] const position& get_start() const override;
Copy link

Copilot AI Jul 16, 2025

Choose a reason for hiding this comment

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

The [[nodiscard]] attribute is inconsistent with the base class declaration. Either add it to the base class or remove it here for consistency.

Copilot uses AI. Check for mistakes.
Comment thread include/reader.hpp
Comment on lines +55 to +60
struct token final {
token_kind kind;
position pos;
std::string word;

virtual ~token();
~token();
Copy link

Copilot AI Jul 16, 2025

Choose a reason for hiding this comment

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

Adding final to the token struct may be a breaking change if client code previously inherited from token. The destructor was also changed from virtual to non-virtual, which could cause issues if there are existing derived classes.

Copilot uses AI. Check for mistakes.
Comment thread include/reader.hpp
std::string word;

virtual ~token();
~token();
Copy link

Copilot AI Jul 16, 2025

Choose a reason for hiding this comment

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

Removing the virtual keyword from the destructor while adding final to the class is correct, but this is a breaking change if existing code inherits from token.

Copilot uses AI. Check for mistakes.
Comment thread include/reader.hpp
~token();

virtual void dump(
void dump(
Copy link

Copilot AI Jul 16, 2025

Choose a reason for hiding this comment

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

Removing the virtual keyword from the dump method is a breaking change that could affect polymorphic behavior if client code relies on virtual dispatch.

Copilot uses AI. Check for mistakes.
@ninjaro ninjaro merged commit 1dfe2c3 into master Jul 16, 2025
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants