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

Init docs site #25

Merged
merged 13 commits into from
Jun 8, 2024
Merged

Init docs site #25

merged 13 commits into from
Jun 8, 2024

Conversation

bleudev
Copy link
Member

@bleudev bleudev commented Jun 8, 2024

closes #24

Summary by Sourcery

This pull request sets up a documentation site for the ufpy package using MkDocs with the Material theme. It includes configuration for Read the Docs, various MkDocs plugins, and markdown extensions. The documentation covers the UDict and UStack classes, generators, type checking protocols, and type aliases.

  • New Features:
    • Initialized a documentation site using MkDocs with the Material theme.
    • Added documentation for the UDict and UStack classes, various generators, type checking protocols, and type aliases.
  • Enhancements:
    • Configured MkDocs with various plugins and markdown extensions to enhance the documentation site.
  • Build:
    • Added a Read the Docs configuration file to automate the build and deployment of the documentation site.
  • Documentation:
    • Created an index page with an introduction to the ufpy package, installation instructions, and usage examples.
    • Added individual documentation pages for UDict, UStack, generators, type checking protocols, and type aliases.

@bleudev bleudev added the documentation Improvements or additions to documentation label Jun 8, 2024
@bleudev bleudev added this to the 1.0 milestone Jun 8, 2024
@bleudev bleudev self-assigned this Jun 8, 2024
@bleudev bleudev linked an issue Jun 8, 2024 that may be closed by this pull request
Copy link
Contributor

sourcery-ai bot commented Jun 8, 2024

Reviewer's Guide by Sourcery

This pull request sets up the initial documentation site for the 'ufpy' package using MkDocs with the Material theme. It includes configuration files for MkDocs and Read the Docs, as well as initial documentation content for various features of the 'ufpy' package.

File-Level Changes

Files Changes
docs/useful_classes/udict.md
docs/useful_classes/ustack.md
Added documentation for useful classes 'UDict' and 'UStack'.
docs/type_checking/protocols.md
docs/type_checking/type_alias.md
Added documentation for type checking protocols and type aliases.
docs/source/conf.py
docs/source/index.md
Removed old Sphinx documentation files.

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
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

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

Привет, @bleudev - я просмотрел ваши изменения, и они выглядят отлично!

Вот что я рассмотрел во время проверки
  • 🟡 Общие проблемы: найдено 7 проблем
  • 🟢 Безопасность: все выглядит хорошо
  • 🟢 Тестирование: все выглядит хорошо
  • 🟢 Сложность: все выглядит хорошо

Sourcery бесплатен для open source - если вам нравятся наши обзоры, пожалуйста, подумайте о том, чтобы поделиться ими ✨
Помогите мне быть полезнее! Пожалуйста, нажмите 👍 или 👎 на каждый комментарий, чтобы сообщить, был ли он полезен.
Original comment in English

Hey @bleudev - I've reviewed your changes and they look great!

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

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.

docs/index.md Outdated Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
docs/useful_classes/udict.md Show resolved Hide resolved
docs/generators.md Show resolved Hide resolved
docs/type_checking/protocols.md Show resolved Hide resolved
docs/type_checking/type_alias.md Show resolved Hide resolved
docs/useful_classes/ustack.md Show resolved Hide resolved
@bleudev
Copy link
Member Author

bleudev commented Jun 8, 2024

Approved

@bleudev bleudev merged commit eec20cc into main Jun 8, 2024
2 checks passed
@bleudev bleudev deleted the docs-index branch June 8, 2024 19:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Docs: Index
1 participant