Hi! Thank you so much for your time in advance!
We have adopted Netlify to serve our product’s docs and website recently and so far it works like a charm, our contributors on Github particularly love the deployment preview (or featurepeek?) feature, which really helps improve the documentation contribution workflow.
However, recently we decided to move forward with a multi-repo setup, which brings a challenge to us when it comes to the deploy preview feature:
Context
we have a (C++/Python) application repo storing source code, and a separate (Docusaurus/ReactJS based statically generated website) website repo hosting the website and (markdown) docs and other static assets.
current workflow
We ask all documentation contirbutors to go to our (Docusaurus-based) website repo to add/update the markdown files directly, and when they make a Pull Request, the Netlify bot will kindly comment on the PR, posting the preview link or logs. This is smooth.
Desired workflow
We plan to move our source content (i.e. the markdown files) to our application codebase (another repository) from the website repo, in order to encourage source code contributors update the docs simultaneously, and we will create a cron job that syncs/copies the markdown content from the application repo back to the documentation website repo nightly.
TL,DR;
In short, we want whoever updates the docs content in our application repo to be able to see a preview website in the Pull Requests. This is not feasible now since the Netlify build hook is connected to the website repo not the application repo. However, it won’t work either if we update that hook since the application repo has nothing but a list of markdown files (i.e. lack of Javascript/CSS/HTML build context).
I’m wondering if this is something achievable on the Netlify side without requiring us to build some custom Github hooks/Actions, and it would be surprising if we are the first to run into similar challenges, since this is similar to having multiple content-only blog/news/tutorials repos connected to one major website repo, with the requirement that all PRs in all those multi-repos triggering deploy-previews
(It seems that Netlify CMS might be a good candidate for such requirement? But we want to keep our current Git based workflow than asking our contributors adopt the editor-view pipeline, so not sure if it’s an overkill)
Please let me know if there are any resources that may help! Thanks!!