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

[docs] Improve docs styles #461

Merged
merged 6 commits into from
Jan 20, 2025

Conversation

NikitaZotov
Copy link
Member

@NikitaZotov NikitaZotov commented Jan 19, 2025


Important

Improves documentation styles and usability by updating mkdocs.yml, main.css, README.md, and adding changelog entry.

  • Documentation Usability:
    • Updated mkdocs.yml to add search, edit links, copy code blocks, and logo.
    • Justified text alignment in main.css.
    • Changed local server address in README.md from 8000 to 8002.
  • Changelog:
    • Added entry for improved documentation usability in changelog.md.

This description was created by Ellipsis for 2734caf. It will automatically update as commits are pushed.

@NikitaZotov NikitaZotov self-assigned this Jan 19, 2025
@NikitaZotov NikitaZotov added documentation Improvements or additions to documentation 0.10.0 labels Jan 19, 2025
@NikitaZotov NikitaZotov added this to the 0.10.0 milestone Jan 19, 2025
Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

👍 Looks good to me! Reviewed everything up to c1c74c2 in 53 seconds

More details
  • Looked at 58 lines of code in 2 files
  • Skipped 0 files when reviewing.
  • Skipped posting 1 drafted comments based on config settings.
1. docs/_assets/main.css:1
  • Draft comment:
    Applying text-align: justify; to all p elements might not be suitable for all paragraphs. Consider scoping this style to specific sections or classes if not all text should be justified.
  • Reason this comment was not posted:
    Confidence changes required: 50%
    The CSS rule for p elements applies text justification globally, which might not be desirable for all paragraphs.

Workflow ID: wflow_4V3gOYM9rkbfkHkU


You can customize Ellipsis with 👍 / 👎 feedback, review rules, user-specific overrides, quiet mode, and more.

@NikitaZotov
Copy link
Member Author

@ellipsis: approve this PR

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

👍 Looks good to me! Reviewed everything up to c1c74c2 in 12 seconds

More details
  • Looked at 58 lines of code in 2 files
  • Skipped 0 files when reviewing.
  • Skipped posting 1 drafted comments based on config settings.
1. docs/_assets/main.css:2
  • Draft comment:
    Ensure that the text-align: justify; rule for paragraphs aligns with the overall design guidelines of the project.
  • Reason this comment was not posted:
    Confidence changes required: 33%
    The addition of the text-align: justify; rule for paragraphs is a stylistic choice. However, it should be confirmed that this aligns with the overall design guidelines of the project.

Workflow ID: wflow_XVtc6bocPbTrn40E


You can customize Ellipsis with 👍 / 👎 feedback, review rules, user-specific overrides, quiet mode, and more.

@NikitaZotov NikitaZotov changed the title [docs] Add search, edit links, text justifying [docs] Add search, edit links, justifying text Jan 19, 2025
@NikitaZotov NikitaZotov linked an issue Jan 19, 2025 that may be closed by this pull request
Copy link

codecov bot commented Jan 19, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Please upload report for BASE (main@dbcc8c3). Learn more about missing BASE report.
Report is 43 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #461   +/-   ##
=======================================
  Coverage        ?   95.76%           
=======================================
  Files           ?      237           
  Lines           ?    27369           
  Branches        ?     1877           
=======================================
  Hits            ?    26211           
  Misses          ?     1158           
  Partials        ?        0           

@NikitaZotov NikitaZotov requested a review from KovalM January 19, 2025 11:12
@NikitaZotov NikitaZotov changed the title [docs] Add search, edit links, justifying text [docs] Improve docs styles (add search, edit links, justifying text, and many other) Jan 19, 2025
@NikitaZotov NikitaZotov changed the title [docs] Improve docs styles (add search, edit links, justifying text, and many other) [docs] Improve docs styles Jan 19, 2025
@NikitaZotov
Copy link
Member Author

@ellipsis: Update PR header

Copy link

ellipsis-dev bot commented Jan 19, 2025

It seems like the request is to update the PR title to better reflect the changes made. The current title is '[docs] Improve docs styles', which might be a bit vague. A more descriptive title could be '[docs] Add search, edit links, and text justification'. However, I'm unable to directly update the PR title through this interface. Could you please update the title to something more descriptive, or let me know if there's a specific way you'd like it changed?


Responding to this comment by @NikitaZotov. For more information about Ellipsis, check the documentation.

@NikitaZotov
Copy link
Member Author

It seems like the request is to update the PR title to better reflect the changes made. The current title is '[docs] Improve docs styles', which might be a bit vague. A more descriptive title could be '[docs] Add search, edit links, and text justification'. However, I'm unable to directly update the PR title through this interface. Could you please update the title to something more descriptive, or let me know if there's a specific way you'd like it changed?

Responding to this comment by @NikitaZotov. For more information about Ellipsis, check the documentation.

@ellipsis: Review PR, I made new changes

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

👍 Looks good to me! Reviewed everything up to 4bb15fd in 10 seconds

More details
  • Looked at 93 lines of code in 2 files
  • Skipped 0 files when reviewing.
  • Skipped posting 1 drafted comments based on config settings.
1. mkdocs.yml:99
  • Draft comment:
    The 'extra_css' and 'extra_javascript' sections have been moved. Ensure this change is intentional as it might affect the loading order.
  • Reason this comment was not posted:
    Confidence changes required: 50%
    The 'extra_css' and 'extra_javascript' sections were moved in the mkdocs.yml file, but they are still present. This is not a bug, but it is worth noting that the order of these sections has changed. This might affect the loading order of CSS and JavaScript files, which could be intentional or accidental.

Workflow ID: wflow_ZnJ0my7RFhRvCZT1


You can customize Ellipsis with 👍 / 👎 feedback, review rules, user-specific overrides, quiet mode, and more.

@NikitaZotov
Copy link
Member Author

@ellipsis: Review this PR

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

👍 Looks good to me! Reviewed everything up to 74d0ad5 in 14 seconds

More details
  • Looked at 96 lines of code in 3 files
  • Skipped 0 files when reviewing.
  • Skipped posting 1 drafted comments based on config settings.
1. docs/changelog.md:241
  • Draft comment:
    Add a period at the end of the sentence for consistency.
- Improve docs usability: add search, edit links, coping code blocks, logo, text justifying, move sections to header and other.
  • Reason this comment was not posted:
    Confidence changes required: 10%
    The changelog entry is missing a period at the end of the sentence. This is a minor formatting issue.

Workflow ID: wflow_8WRROSKALc5txx1u


You can customize Ellipsis with 👍 / 👎 feedback, review rules, user-specific overrides, quiet mode, and more.

Copy link
Member

@kilativ-dotcom kilativ-dotcom left a comment

Choose a reason for hiding this comment

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

change 8000 in readme

@NikitaZotov
Copy link
Member Author

@ellipsis: Review this PR

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

👍 Looks good to me! Reviewed everything up to 2734caf in 18 seconds

More details
  • Looked at 110 lines of code in 4 files
  • Skipped 1 files when reviewing.
  • Skipped posting 1 drafted comments based on config settings.
1. README.md:51
  • Draft comment:
    Ensure the port number (8002) matches the one in mkdocs.yml for consistency.
  • Reason this comment was not posted:
    Confidence changes required: 50%
    The change in the port number from 8000 to 8002 in the README.md file should be reflected in the mkdocs.yml file as well to maintain consistency.

Workflow ID: wflow_7RQZuOz2y4mLVxHb


You can customize Ellipsis with 👍 / 👎 feedback, review rules, user-specific overrides, quiet mode, and more.

@NikitaZotov NikitaZotov merged commit 3166027 into ostis-ai:main Jan 20, 2025
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
0.10.0 documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Run documentation not on port 8000
3 participants