Context

When working with the projects plugin, a newly created project is not getting picked up. While it is relatively easy to trigger a re-build by touching the main mkdocs.yml, it would be nice if new projects were picked up automatically.

It is debatable whether this constitutes a bug or a change request. I went with the latter since this should not be blocker for anyone.

Description

I am proposing to add something to the configuration of the file system watcher that would identify a new subdirectory in the projects_dir. Looking at the documentation of the watchdog library used, it seems this should be possible.

Related links

• Requesting a change
• https://python-watchdog.readthedocs.io/en/stable/api.html#watchdog.events.FileSystemEventHandler.on_created
• https://github.com/squidfunk/mkdocs-material-insiders/blob/199b01479f8770cee3a3b3456edf0103c68bd468/src/plugins/projects/plugin.py#L336

Use Cases

This applies for any use of the projects plugin. It may be more important to some uses than others, since in some there will be plenty new subprojects being created all the time, while other users may have a limited and static set of subprojects.

Visuals

No response

Before submitting

• I have read and followed the change request guidelines.
• I have verified that my idea is a change request and not a bug report.
• I have ensured that, to the best of my knowledge, my idea will benefit the entire community.
• I have included relevant links to the documentation, related issues, and discussions to underline the need for my idea.