As I have been updating the documentation it comes to my mind- why does the website exist in this already very dense repo containing all the application logic? In recent years there was this "trend" towards monorepos, and with code projects including multiple related modules a monorepo makes sense vs. git sub-modules.
But why include a whole website which contains documentation and should be regularly updated and maintained? The one argument i've heard (from other projects) is this helps keep the documentation more up-to-date. Nice theory, but in practice (especially that of Decap CMS and my recent efforts to update Beta Features) just having the docs pages in the same repo does not help enforce such updating.
The very obvious benefits I see of a separate website repo are:
Smaller repo sizes
More granular ACL of contributors and maintainers
Less clutter in the issue tracker and notifications
Less effort to maintain branch sync with HEAD re: to entirely unrelated updates done to the code
Apologies if this is a not-up-for-discussion topic due to history, but it seems like maybe under new leadership this is worth revisting.
As I have been updating the documentation it comes to my mind- why does the
websiteexist in this already very dense repo containing all the application logic? In recent years there was this "trend" towards monorepos, and with code projects including multiple related modules a monorepo makes sense vs. git sub-modules.But why include a whole website which contains documentation and should be regularly updated and maintained? The one argument i've heard (from other projects) is this helps keep the documentation more up-to-date. Nice theory, but in practice (especially that of Decap CMS and my recent efforts to update Beta Features) just having the docs pages in the same repo does not help enforce such updating.
The very obvious benefits I see of a separate
websiterepo are:HEADre: to entirely unrelated updates done to the codeApologies if this is a not-up-for-discussion topic due to history, but it seems like maybe under new leadership this is worth revisting.