🔧 Repository: Documentation & Guidelines on Local Plugin Development
jrtaylorJH opened this issue · comments
📜 Description
Backstage and community plugin repo documentation severely lack a description and/or general set of guidelines on how best to actively develop and test code in this repository locally. There should be specific documentation provided that explains how best to clone this repo and develop locally against one or more of the plugins. I believe that this would substantially improve community engagement, and at least create a uniform starting point that conversations around developing these plugins can operate upon.
👍 Expected behavior
A clear and concise README.md or CONTRIBUTING.md file containing step-by-step instructions for local development and contribution to this repository.
👎 Current Behavior
Lack of centralized documentation
👟 Reproduction steps
N/A
📃 Provide the context for the Bug.
Sometimes, we create a test app in order to assist with local development, as in this example. However, this is only present in very few of the plugin directories, and the only way to divine this process is to locate a similar PR or extrapolate from unrelated Backstage guides that sort of indirectly articulate this process.
Roadie's documentation for their plugin monorepo is a great place to start. While their repository structure is different and allows for a shared test app, they at least sort of (and rather imperfectly) describe the steps it takes to get up and running with local development.
👀 Have you spent some time to check if this bug has been raised before?
- I checked and didn't find similar issue
🏢 Have you read the Code of Conduct?
- I have read the Code of Conduct
Are you willing to submit PR?
No, but I'm happy to collaborate on a PR with someone else