Mosheh, a tool for creating docs for projects, from Python to Python.

code-generation console documentation markdown mkdocs mkdocs-material text-processing
5 Open Issues Need Help Last updated: Jul 25, 2025

Open Issues Need Help

View All on GitHub
Developer Tools Documentation Generators
good first issue refactor

Mosheh, a tool for creating docs for projects, from Python to Python.

Python
#code-generation#console#documentation#markdown#mkdocs#mkdocs-material#text-processing
Developer Tools Documentation Generators

AI Summary: Refactor the Mosheh Python codebase by replacing a custom binary search function (`mosheh.utils.bin`) with Python's built-in `in` operator. This is justified by performance benchmarks showing negligible difference for the relevant data sizes used by Mosheh, prioritizing code simplicity and maintainability.

Complexity: 2/5
good first issue refactor

Mosheh, a tool for creating docs for projects, from Python to Python.

Python
#code-generation#console#documentation#markdown#mkdocs#mkdocs-material#text-processing
Developer Tools Documentation Generators

AI Summary: Refactor the Python codebase of the Mosheh project to simplify long import statements from the `mosheh.types` module. The current imports span multiple lines, impacting readability. The proposed solution involves importing the `basic`, `contracts`, and `enums` modules from `mosheh.types` instead of individually importing each element within those modules. This will require updating code and documentation where necessary.

Complexity: 2/5
good first issue refactor

Mosheh, a tool for creating docs for projects, from Python to Python.

Python
#code-generation#console#documentation#markdown#mkdocs#mkdocs-material#text-processing
Developer Tools Documentation Generators

AI Summary: Implement support for documenting Python type aliases (`ast.TypeAlias`) in the Mosheh documentation generator. This involves adding a new handler function to process type alias nodes, updating the markdown structure, enums, and unit tests accordingly.

Complexity: 3/5
enhancement good first issue

Mosheh, a tool for creating docs for projects, from Python to Python.

Python
#code-generation#console#documentation#markdown#mkdocs#mkdocs-material#text-processing
Developer Tools Documentation Generators

AI Summary: Refactor Mosheh's type contracts from dataclasses to NamedTuples to improve performance and memory efficiency. This involves replacing dataclass definitions with NamedTuple equivalents and updating code to use the _asdict() method for dictionary conversion. Benchmarking results will need to be reviewed and integrated into the pull request.

Complexity: 4/5
good first issue refactor

Mosheh, a tool for creating docs for projects, from Python to Python.

Python
#code-generation#console#documentation#markdown#mkdocs#mkdocs-material#text-processing