Does anyone have any experience with #docusaurus in multi-repository setup? More in 🧵
[#]javascript #devx
=> More informations about this toot | More toots from ondrej@social.synacek.org
My goal is to gather various documentation sources from multiple repositories into single source of truth (Docusaurus documentation site). I know it's not the usual way to do this. Basically I will need to pull in markdown files from different repositories and build the site, without checking all of these gathered files into the documentation (Docusaurus) repository. The reason to do this is because the source of truth is in those other repositories (co-location with code). 🧵
=> More informations about this toot | More toots from ondrej@social.synacek.org
We like to keep it this way, originally mkdocs was used to serve this documentation. This proved to be insufficient though so looking for replacement.
The tricky part is the build process in CI. I couldn't think of anything better other than putting these markdown files to S3 bucket, which in turn triggers the build process in the "docusaurus" repo (our internal doc site). (1/2)
=> More informations about this toot | More toots from ondrej@social.synacek.org
The only thing missing from this setup is the validation part. The validation happens when you run docusaurs build and checks whether links are valid etc. I'd like to run this validation part without installing Docusarus, but not sure if it's possible. (2/2)
=> More informations about this toot | More toots from ondrej@social.synacek.org This content has been proxied by September (ba2dc).Proxy Information
text/gemini