Skip to content

Conversation

@MonaaEid
Copy link
Contributor

@MonaaEid MonaaEid commented Dec 19, 2025

Description

This pull request introduces a new issue template designed specifically for advanced contributors to the Hiero Python SDK project. The template guides experienced developers in reporting high-impact issues that may affect core SDK behavior, ensuring submissions are detailed, actionable, and aligned with project standards.

Enhancements to contributor workflow:

  • Added a dedicated advanced issue template (.github/ISSUE_TEMPLATE/06_advanced_issue.yml) that provides structured prompts for problem description, proposed solution, implementation notes, and acceptance criteria, targeting contributors with deep familiarity with the SDK.
  • Updated the changelog to document the addition of the advanced issue template for improved transparency and discoverability.

Related issue(s):
Fixes #1139

Checklist

  • Created .github/ISSUE_TEMPLATE/06_advanced_issue.yml
  • Updated CHANGELOG.md
  • Tested

Summary by CodeRabbit

  • Documentation
    • Added a new "Advanced" issue template to help contributors file complex, multi-module design requests. The template guides reporters through required sections (intro, problem, solution, implementation notes, acceptance criteria, additional context) and provides prompts about scope, risk, compatibility, testing, and documentation to improve clarity and reviewability of deep technical changes.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai
Copy link

coderabbitai bot commented Dec 19, 2025

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Walkthrough

Adds a new GitHub issue form template for "Advanced" issues at .github/ISSUE_TEMPLATE/06_advanced_issue.yml and updates CHANGELOG.md to record the addition. The template defines metadata, required/optional form fields, inline guidance, and labels/title prefix.

Changes

Cohort / File(s) Summary
GitHub Issue Template
.github/ISSUE_TEMPLATE/06_advanced_issue.yml
New GitHub issue form added. Defines metadata (name, description, title prefix, labels, assignees) and a multi-section body with intro, required Problem, required Solution, Implementation & Design Notes, required Acceptance Criteria, and Additional Context. Includes guidance/examples and validation for required fields.
Changelog Update
CHANGELOG.md
Added an "Added" entry documenting the new Advanced issue template.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Review focus: YAML syntax/validation, required fields and labels, title prefix.
  • Files to double-check: .github/ISSUE_TEMPLATE/06_advanced_issue.yml, CHANGELOG.md.

Suggested reviewers

  • exploreriii

Poem

🐰 In YAML fields I hop and write,
A form for builders working late at night,
For advanced minds who trace each thread,
Clear prompts and labels neatly spread,
Go file an issue — I cheer you bright! ✨

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately and concisely describes the main change: adding a new advanced issue template for contributors, which is the primary focus of this PR.
Linked Issues check ✅ Passed The PR creates the required .github/ISSUE_TEMPLATE/06_advanced_issue.yml template with advanced label, title prefix, required fields, and updates CHANGELOG.md as specified in issue #1139.
Out of Scope Changes check ✅ Passed All changes are directly aligned with issue #1139: only the new advanced issue template file and CHANGELOG.md update are present, with no unrelated modifications.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 782cfda and c1891c8.

📒 Files selected for processing (1)
  • .github/ISSUE_TEMPLATE/06_advanced_issue.yml (1 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (6)
  • GitHub Check: build-and-test (3.10)
  • GitHub Check: build-and-test (3.13)
  • GitHub Check: build-and-test (3.12)
  • GitHub Check: build-and-test (3.11)
  • GitHub Check: run-examples
  • GitHub Check: StepSecurity Harden-Runner
🔇 Additional comments (6)
.github/ISSUE_TEMPLATE/06_advanced_issue.yml (6)

1-6: LGTM! Metadata configuration is correct.

The template metadata properly sets the "advanced" label and "[Advanced]: " title prefix as required, with an appropriate description for advanced contributors.


7-44: LGTM! Welcome message and contributor guidance are clear.

The intro sections effectively communicate expectations for advanced contributors and appropriately direct less experienced developers to other issue types.


71-154: LGTM! Problem and solution sections are well-structured.

The required Problem Description and Proposed/Expected Solution fields provide clear guidance with helpful hidden examples. The structure effectively supports detailed technical discussions appropriate for advanced issues.


155-193: LGTM! Implementation notes section provides comprehensive guidance.

The optional Implementation & Design Notes field appropriately emphasizes technical considerations (modules, refactoring, migration, testing, performance, security) with a helpful hidden example.


194-226: LGTM! Acceptance criteria are comprehensive and complete.

The required Acceptance Criteria field includes all elements specified in issue #1139: problem resolution, backwards compatibility, conventions, comprehensive tests, documentation updates, CI passing, changelog entry, and DCO/GPG-signed commits. The optional Additional Context field appropriately allows for supplementary references.


67-67: No action needed. The docs/sdk_developers/training directory reference is valid and intentional. GitHub supports relative links in markup files, allowing direct linking between documentation files, and the directory exists with multiple training documents (executable.md, network_and_client.md, receipts.md, transaction_lifecycle.md, and others). Directory links render correctly as navigable links on GitHub.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov
Copy link

codecov bot commented Dec 19, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.

Impacted file tree graph

@@           Coverage Diff           @@
##             main    #1152   +/-   ##
=======================================
  Coverage   91.19%   91.19%           
=======================================
  Files         139      139           
  Lines        8446     8446           
=======================================
  Hits         7702     7702           
  Misses        744      744           
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@MonaaEid MonaaEid force-pushed the feat/1139-advanced_issue-template branch 2 times, most recently from b527734 to 8316e3e Compare December 19, 2025 00:50
@MonaaEid MonaaEid force-pushed the feat/1139-advanced_issue-template branch from 8316e3e to 70d467f Compare December 19, 2025 00:51
@MonaaEid MonaaEid marked this pull request as ready for review December 19, 2025 00:57
Copilot AI review requested due to automatic review settings December 19, 2025 00:57
Copy link
Contributor

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 introduces a new advanced issue template to guide experienced contributors in creating high-impact issues for the Hiero Python SDK. The template complements the existing Good First Issue and Intermediate Issue templates by targeting contributors with deep familiarity with the SDK internals.

Key changes:

  • Added .github/ISSUE_TEMPLATE/06_advanced_issue.yml with structured prompts for problem description, proposed solution, implementation notes, and acceptance criteria
  • Updated CHANGELOG.md to document the new template addition

Reviewed changes

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

File Description
.github/ISSUE_TEMPLATE/06_advanced_issue.yml New advanced issue template providing structured guidance for experienced contributors reporting high-impact issues requiring deep SDK knowledge
CHANGELOG.md Added changelog entry documenting the new advanced issue template

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d3201de and 782cfda.

📒 Files selected for processing (2)
  • .github/ISSUE_TEMPLATE/06_advanced_issue.yml (1 hunks)
  • CHANGELOG.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
CHANGELOG.md

[uncategorized] ~54-~54: The official name of this software platform is spelled with a capital “H”.
Context: ...advanced issue template for contributors .github/ISSUE_TEMPLATE/06_advanced_issue.yml. ...

(GITHUB)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (8)
  • GitHub Check: Agent
  • GitHub Check: Codacy Static Code Analysis
  • GitHub Check: build-and-test (3.11)
  • GitHub Check: build-and-test (3.12)
  • GitHub Check: build-and-test (3.13)
  • GitHub Check: build-and-test (3.10)
  • GitHub Check: run-examples
  • GitHub Check: StepSecurity Harden-Runner
🔇 Additional comments (9)
CHANGELOG.md (1)

54-54: LGTM!

The changelog entry accurately documents the addition of the advanced issue template and follows the established formatting conventions.

.github/ISSUE_TEMPLATE/06_advanced_issue.yml (8)

1-6: LGTM! Template metadata is properly configured.

The template metadata correctly implements all requirements:

  • Descriptive name and description for advanced contributors
  • Automatic "[Advanced]: " title prefix
  • Applies "advanced" label automatically
  • Empty assignees list as specified

25-44: Well-structured introductory section.

This section effectively sets expectations for advanced contributors, clearly outlining required skills (SDK internals, multi-module navigation, API design decisions, working independently). Appropriately directs newer developers to starter issues.


71-115: LGTM! Problem section properly configured.

The problem description section is well-designed with:

  • Clear guidance on what to include
  • Properly marked as required
  • Helpful hidden example showing expected detail level
  • Good emphasis on explaining current behavior, insufficiency, and affected components

116-154: LGTM! Solution section properly configured.

The proposed solution section effectively guides contributors to think through:

  • High-level approach and design
  • New abstractions or changes to existing ones
  • Constraints (backwards compatibility, performance, API stability)
  • Alternatives considered

Properly marked as required with helpful hidden example.


155-193: LGTM! Implementation section provides thorough guidance.

This optional section appropriately emphasizes its importance for advanced issues and provides comprehensive guidance on:

  • Specific modules and classes
  • Refactoring strategy
  • Migration/deprecation concerns
  • Testing strategy
  • Performance and security considerations

The hidden example demonstrates the expected level of technical detail.


194-211: LGTM! Acceptance criteria fully aligned with requirements.

The acceptance criteria section includes all required elements from issue #1139:

  • Problem and design goals addressed
  • Backwards compatibility maintained
  • Architectural and coding conventions followed
  • Comprehensive tests for new and existing behavior
  • Examples and documentation updated
  • CI checks passing
  • Changelog entry included
  • DCO and GPG-signed commits

Properly marked as required with clear checklist format.


213-226: LGTM! Additional context section appropriately configured.

This optional section provides helpful guidance on useful references (design docs, prior discussions, related issues/PRs, external references) without requiring contribution. Appropriately placed as the final section.


32-32: The Hiero URL reference is correct. https://hiero.org is the official website of Hiero, which is the appropriate link for the Hiero project documentation and codebase.

@exploreriii exploreriii merged commit d53489c into hiero-ledger:main Dec 19, 2025
20 checks passed
@exploreriii
Copy link
Contributor

Thank you @MonaaEid !

@MonaaEid
Copy link
Contributor Author

MonaaEid commented Dec 19, 2025

Thank you @MonaaEid !

My pleasure!

prajeeta15 pushed a commit to prajeeta15/hiero-sdk-python that referenced this pull request Dec 23, 2025
@MonaaEid MonaaEid deleted the feat/1139-advanced_issue-template branch December 23, 2025 13:02
@coderabbitai coderabbitai bot mentioned this pull request Dec 29, 2025
8 tasks
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.

[Intermediate]: Create .github/ISSUE_TEMPLATE/06_advanced_issue.yml

2 participants