clean up minor issues in docs

[mahf708]

Fixes #489

Highlights:

Notes (if applicable):

Summary by Sourcery

Update the GitHub Actions workflow for building and deploying documentation by renaming the workflow and job names, and adjusting the path for the documentation generation script.

CI:

• Rename the GitHub Actions workflow from 'Build and Deploy Documentation' to 'mkdocs'.
• Change the job name in the GitHub Actions workflow from 'build-deploy' to 'blds'.
• Update the path for the Python script in the GitHub Actions workflow to 'docs/mk_generator.py'.

[sourcery-ai]

Reviewer's Guide by Sourcery

This pull request makes minor changes to the documentation workflow file, including renaming the workflow and a job, and updating the path to the documentation generator script.

No diagrams generated as the changes look simple and do not need a visual representation.

File-Level Changes

Change	Details	Files
Rename the documentation workflow and its main job	Change workflow name from 'Build and Deploy Documentation' to 'mkdocs' Rename the main job from 'build-deploy' to 'blds'	.github/workflows/mkdocs.yml
Update the path to the documentation generator script	Change the path of mk_generator.py from the root directory to the docs directory	.github/workflows/mkdocs.yml

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time.

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[sourcery-ai]

Hey @mahf708 - I've reviewed your changes - here's some feedback:

Overall Comments:

• Consider keeping more descriptive names for the workflow and job. 'Build and Deploy Documentation' and 'build-deploy' are clearer than 'mkdocs' and 'blds' respectively.
• Please provide more context in the PR description about the reasons for these changes. It's not clear how these modifications address the issue mentioned (move mk_generator from root, rename action workflows #489).

Here's what I looked at during the review

• 🟢 General issues: all looks good
• 🟢 Security: all looks good
• 🟢 Testing: all looks good
• 🟢 Complexity: all looks good
• 🟢 Documentation: all looks good

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}