How do you know when to make a single deliverable from one repo or make a large website from multiple repos? The way that you organize information influences how you can present it to readers.

If developers are struggling to write docs in their repo, consider a separate repo for docs. But, if technical accuracy is the higher priority, keep the docs in the dev repo

To decide whether to keep docs in the dev repo, use a single docs repo, or use multiple docs repos, consider your users, contributors, reviewers, content size, automated tests, deployed docs, and translated docs.