Skip to content

Conversation

@ecarrenolozano
Copy link
Contributor

All developments related to this effort are hosted in the docs/mkdocs-migration branch.

✅ Improvements

The template now generates a project with the following features:

  1. Ready-to-use MkDocs Material documentation, following a consistent structure for all Saezlab projects.

  2. GitHub Actions workflows, aligned with best practices:

    • CI workflow for documentation
    • CI workflow for linting
    • CI workflow for unit testing
    • CI workflow for security checks (optional; can be removed if not needed)
  3. Improved pyproject.toml with clearly structured sections.

  4. Improved .pre-commit-config.yaml, with a well-organized layout.

  5. Simplified setup instructions to create a Python project in just a few steps.

🔜 Next Steps

  1. User experience testing: A group of users will go through the process of creating a Python project using the proposed changes.

…fore intend a pull request

fix: refactor licenses configuration in cookicutter and pyproject.toml. Reduce versbosity and improve maintenance

docs: initial commit MkDocs migration for the python-project template.

docs: update content of LICENSE for the python-project template

chores: remove bash scripts with hooks in the template

tests: update placeholder test for the template

chores: delete old README.rst and create a new one with different content in markdown

docs: update README content, this README belongs to the project not to cookiecutter

ci/cd: create workflows for testing, build documentation, security, and quality check

docs: update command to run cookiecutter using saezlab organization

chores: update minimal test file with __all__ method

chores: improve clarity and organization in .pre-commit configuration file

chores: include .python-version file in .gitignore

chores: remove readthedocs.yaml file

chores: improve pyproject.toml file to follow best practices and clear organization

fix: exclude workflows of being rendering with jinja2

docs: fix typos in README (cookiecutter template)

fix: add instructions for installing pre-commit

fix: fix pre-commit versions

fix: update Python version specification in workflows and remove unnecessary .python-version from .gitignore

fix: correct formatting, errors and other outputs with pre-commit

fix: correct formatting, errors and other outputs with pre-commit

fix: correct formatting, errors and other outputs with pre-commit

fix: correct formatting, errors and other outputs with pre-commit

fix: correct formatting, errors and other outputs with pre-commit

fix: correct formatting, errors and other outputs with pre-commit

fix: correct formatting, errors and other outputs with pre-commit

chores: edit badges with updated content
@ecarrenolozano ecarrenolozano added the enhancement New feature or request label Jun 11, 2025
@deeenes deeenes merged commit 9994d74 into master Sep 10, 2025
0 of 8 checks passed
@ecarrenolozano ecarrenolozano deleted the docs/mkdocs-migration branch November 28, 2025 12:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants