{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation/2"},{"label":"Documentation","url":"https://skillfed.io/packages/category/software-development-documentation"}],"enrichment":{"capability":"A ProperDocs plugin that allows placing the properdocs.yml configuration file in the same directory as your documentation files, rather than requiring it to be in a separate parent directory.","skillfed_tags":["mkdocs-plugin","properdocs"],"use_cases":["Organizing documentation projects where config and content live together in a single directory for simpler repository structure.","Migrating existing documentation layouts to colocate properdocs.yml with markdown files without restructuring the entire docs folder.","Building documentation sites where the configuration file is version-controlled alongside the documentation it describes."],"what_it_does":"mkdocs-same-dir is a plugin for ProperDocs that relaxes the normal directory layout constraint, allowing you to place your properdocs.yml configuration file in the same directory as your documentation files instead of requiring it to live in a parent directory. This simplifies project structure for documentation-heavy repositories where you want the config and content colocated.\n\nThe plugin works by monkeypatching ProperDocs' internals to permit docs_dir to be set to `.` (the current directory). A key side effect is that non-Markdown files at the root of the docs directory are no longer picked up automatically\u2014only Markdown files are included. The maintainer has committed to keeping the plugin compatible with ProperDocs updates, though the implementation's reliance on internal patching means compatibility cannot be guaranteed indefinitely.","worth_installing":"Yes, if you use ProperDocs and want to colocate properdocs.yml with your docs directory. The plugin is actively maintained, has no known vulnerabilities, and carries a permissive MIT license. The main trade-off is the monkeypatch approach\u2014it works reliably today but depends on the maintainer tracking ProperDocs changes. Suitable for projects where this layout simplification justifies that dependency."},"id":"mkdocs-same-dir","links":{"html":"https://skillfed.io/packages/mkdocs-same-dir","md":"https://skillfed.io/packages/mkdocs-same-dir.md","pypi":"https://pypi.org/project/mkdocs-same-dir/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-04-17","license_spdx":"MIT","license_treatment":"permissive","name":"mkdocs-same-dir","python_support":"supports_current","summary":"ProperDocs plugin to allow placing properdocs.yml in the same directory as documentation"},"popularity":{"monthly_downloads":133271,"position":11523,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.1.5"}