Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add edit page button and link to GitHub in docs #1

Open
wants to merge 5 commits into
base: base-sha/d4bb73f3c0039acaf59a9542b8c6a35e1a158cc7
Choose a base branch
from

Conversation

sourcery-ai-experiments-bot
Copy link
Collaborator

@sourcery-ai-experiments-bot sourcery-ai-experiments-bot commented Jun 19, 2024

One of the minor items in theochem#204.

Based on:

I will YOLO-merge this on Friday, June 21, unless reviewed earlier

Summary by Sourcery

This pull request updates the documentation configuration to include a button for editing pages and a link to the GitHub repository in the footer, using embedded SVG for the GitHub icon as recommended by the Furo theme.

  • Documentation:
    • Added a button to edit pages and a link to the GitHub repository in the documentation footer.

@sourcery-ai-experiments-bot
Copy link
Collaborator Author

This is a benchmark review for experiment review_of_reviews_20240619.
Run ID: review_of_reviews_20240619/benchmark_2024-06-19T00-17-37_v1-19-0-47-gadbf12d93.

This pull request was cloned from https://github.com/theochem/iodata/pull/342. (Note: the URL is not a link to avoid triggering a notification on the original pull request.)

Experiment configuration
review_config:
  # User configuration for the review
  # - benchmark - use the user config from the benchmark reviews
  # - <value> - use the value directly
  user_review_config:
    enable_ai_review: true
    enable_rule_comments: false

    enable_complexity_comments: benchmark
    enable_docstring_comments: benchmark
    enable_security_comments: benchmark
    enable_tests_comments: benchmark
    enable_comment_suggestions: benchmark
    enable_functionality_review: benchmark

    enable_pull_request_summary: benchmark
    enable_review_guide: benchmark

    enable_approvals: true

  ai_review_config:
    # The model responses to use for the experiment
    # - benchmark - use the model responses from the benchmark reviews
    # - llm - call the language model to generate responses
    model_responses:
      comments_model: benchmark
      comment_validation_model: benchmark
      comment_suggestion_model: benchmark
      complexity_model: benchmark
      docstrings_model: benchmark
      functionality_model: benchmark
      security_model: benchmark
      tests_model: benchmark

# The pull request dataset to run the experiment on
pull_request_dataset:
- https://github.com/kaondix/generative_ai_with_langchain/pull/1
- https://github.com/ShiroePL/Cooler-Ai-chan/pull/40
- https://github.com/ShiroePL/Cooler-Ai-chan/pull/34
- https://github.com/ShiroePL/Cooler-Ai-chan/pull/35
- https://github.com/ShiroePL/Cooler-Ai-chan/pull/36
- https://github.com/ShiroePL/Cooler-Ai-chan/pull/37
- https://github.com/ShiroePL/Cooler-Ai-chan/pull/38
- https://github.com/ShiroePL/Cooler-Ai-chan/pull/39
- https://github.com/ShiroePL/Cooler-Ai-chan/pull/41
- https://github.com/ShiroePL/Cooler-Ai-chan/pull/42
- https://github.com/haalasz/fm-tools/pull/5
- https://github.com/elixir-cloud-aai/drs-filer/pull/56
- https://github.com/klept0/MS-Rewards-Farmer/pull/123
- https://github.com/flet-dev/flet/pull/3484
- https://github.com/cpp-lln-lab/bidspm/pull/1248
- https://github.com/theochem/iodata/pull/342
- https://github.com/nuxeo/nuxeo-drive/pull/5009
- https://github.com/nuxeo/nuxeo-drive/pull/5010
- https://github.com/nuxeo/nuxeo-drive/pull/5011
- https://github.com/nuxeo/nuxeo-drive/pull/5012
- https://github.com/hacksider/Deep-Live-Cam/pull/40
- https://github.com/hbmartin/podcast-transcript-tools/pull/4
- https://github.com/hbmartin/podcast-transcript-tools/pull/9
- https://github.com/cerylhusson/prof-met-rec/pull/4
- https://github.com/erxes/erxes/pull/5413
- https://github.com/erxes/erxes/pull/5414
- https://github.com/erxes/erxes/pull/5415
- https://github.com/erxes/erxes/pull/5417
- https://github.com/erxes/erxes/pull/5418
- https://github.com/erxes/erxes/pull/5419
- https://github.com/supabase-community/auth-py/pull/528
- https://github.com/erxes/erxes/pull/5416
- https://github.com/yazdipour/OmnivoreQL/pull/23
- https://github.com/ignition-api/8.1/pull/285
- https://github.com/ydonchoi/Study_solve_problems/pull/4
- https://github.com/yazdipour/OmnivoreQL/pull/24
- https://github.com/vicb/flyxc/pull/242
- https://github.com/vicb/flyxc/pull/244
- https://github.com/mraniki/tt/pull/1633
- https://github.com/mraniki/findmyorder/pull/377
- https://github.com/mraniki/dxsp/pull/681
- https://github.com/mraniki/tt/pull/1634
- https://github.com/mraniki/tt/pull/1635
- https://github.com/mraniki/tt/pull/1636
- https://github.com/mraniki/tt/pull/1637
- https://github.com/mraniki/tt/pull/1638
- https://github.com/mraniki/tt/pull/1639
- https://github.com/Bilbottom/advent-of-code/pull/24
- https://github.com/Bilbottom/sql-learning-materials/pull/24
- https://github.com/luong-komorebi/terraform-aws-rds-alarms/pull/2
review_comment_labels:
- label: correct
  question: Is this comment correct?
- label: helpful
  question: Is this comment helpful?
- label: comment-type
  question: Is the comment type correct?
- label: comment-area
  question: Is the comment area correct?
- label: llm-test
  question: |
    What type of LLM test could this comment become?
    - 👍 - this comment is really good/important and we should always make it
    - 👎 - this comment is really bad and we should never make it
    - no reaction - don't turn this comment into an LLM test

# Benchmark reviews generated by running
#   python -m scripts.experiment benchmark <experiment_name>
benchmark_reviews: []

@SourceryAI
Copy link

SourceryAI commented Jun 19, 2024

Reviewer's Guide by Sourcery

This pull request updates the documentation configuration to enhance user experience by adding a button for editing pages and a link to the GitHub repository. The changes are implemented in the 'docs/conf.py' file, where configurations for embedding a GitHub SVG icon, setting the source repository, branch, and directory, and adding a footer icon for the GitHub link are added.

File-Level Changes

Files Changes
docs/conf.py Updated documentation configuration to include a button for editing pages and a link to the GitHub repository.

Tips
  • Trigger a new Sourcery review by commenting @sourcery-ai review on the pull request.
  • You can change your review settings at any time by accessing your dashboard:
    • Enable or disable the Sourcery-generated pull request summary or reviewer's guide;
    • Change the review language;
  • You can always contact us if you have any questions or feedback.

Copy link

@SourceryAI SourceryAI left a comment

Choose a reason for hiding this comment

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

Hey @sourcery-ai-experiments-bot - I've reviewed your changes and they look great!

Here's what I looked at during the review
  • 🟡 General issues: 3 issues found
  • 🟢 Security: all looks good
  • 🟢 Testing: all looks good
  • 🟢 Complexity: all looks good
  • 🟢 Documentation: all looks good

LangSmith trace

Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.

@@ -48,6 +48,23 @@
html_theme = "furo"
html_static_path = ["_static"]
html_css_files = ["css/table.css"]
# Embedded SVG as recommended in Furo template.
# See https://pradyunsg.me/furo/customisation/footer/#using-embedded-svgs
with open("github.svg") as fh:

Choose a reason for hiding this comment

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

suggestion (bug_risk): Consider adding error handling for file operations.

Opening a file without error handling can lead to unhandled exceptions if the file is missing or unreadable. Consider adding a try-except block to handle potential IOError or FileNotFoundError.

Suggested change
with open("github.svg") as fh:
try:
with open("github.svg") as fh:
GITHUB_ICON_SVG = fh.read().strip()
except (IOError, FileNotFoundError) as e:
GITHUB_ICON_SVG = ""
print(f"Error reading github.svg: {e}")

Choose a reason for hiding this comment

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

Is this comment correct?

Choose a reason for hiding this comment

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

Is this comment helpful?

Choose a reason for hiding this comment

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

Is the comment type correct?

Choose a reason for hiding this comment

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

Is the comment area correct?

Choose a reason for hiding this comment

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

What type of LLM test could this comment become?

  • 👍 - this comment is really good/important and we should always make it
  • 👎 - this comment is really bad and we should never make it
  • no reaction - don't turn this comment into an LLM test

# See https://pradyunsg.me/furo/customisation/footer/#using-embedded-svgs
with open("github.svg") as fh:
GITHUB_ICON_SVG = fh.read().strip()
html_theme_options = {

Choose a reason for hiding this comment

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

suggestion: Consider adding a comment explaining the purpose of html_theme_options.

Adding a brief comment explaining the purpose of the html_theme_options dictionary can improve code readability and maintainability.

Suggested change
html_theme_options = {
# Configuration options for the HTML theme
html_theme_options = {

Choose a reason for hiding this comment

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

Is this comment correct?

Choose a reason for hiding this comment

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

Is this comment helpful?

Choose a reason for hiding this comment

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

Is the comment type correct?

Choose a reason for hiding this comment

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

Is the comment area correct?

Choose a reason for hiding this comment

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

What type of LLM test could this comment become?

  • 👍 - this comment is really good/important and we should always make it
  • 👎 - this comment is really bad and we should never make it
  • no reaction - don't turn this comment into an LLM test

"name": "GitHub",
"url": "https://github.com/theochem/iodata",
"html": GITHUB_ICON_SVG,
"class": "",

Choose a reason for hiding this comment

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

question: Clarify the purpose of the empty class attribute.

An empty class attribute might be confusing to future maintainers. Consider adding a comment explaining why it is left empty or if it is intended to be populated later.

Choose a reason for hiding this comment

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

Is this comment correct?

Choose a reason for hiding this comment

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

Is this comment helpful?

Choose a reason for hiding this comment

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

Is the comment type correct?

Choose a reason for hiding this comment

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

Is the comment area correct?

Choose a reason for hiding this comment

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

What type of LLM test could this comment become?

  • 👍 - this comment is really good/important and we should always make it
  • 👎 - this comment is really bad and we should never make it
  • no reaction - don't turn this comment into an LLM test

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.

3 participants