Setup Netlify site for yard docs #3019
Conversation
We want to deploy several sites from the same repo (guides and docs) and therefore need to use the admin UI to configure them.
We do not need to install all three database adapters at once. As we already set the `DB` env var during CI builds and the local sandbox runs with sqlite anyway, we can safely only install these gems on demand.
|
@tvdeyen is the Netlify failure normal here? |
|
@kennyadsl No. I need to make some more adjustments. Stay tuned |
Although there is the `--yardopts` file option and we only build docs for the `/core` (yet), I think it is best to share the options for all subfolders. Also does not require the gem on boot as we only run yard via command line anyway.
|
@kennyadsl ready ✅ |
|
Ideally we would only install gems that are necessary to build the docs (namely |
|
@kennyadsl thanks. I was able to disable all gem groups we don't need with setting the ENV var in the Netlify admin. This should safe some resources 🐳 |
The local Gemfile (only used for CI and tooling) was grouped for frontend and backend only yet. In order to be able to install only a subset of gems (for generating docs for example) we should group all gems.
|
By grouping all gems I was able to reduce the gems needed to install to just https://app.netlify.com/sites/solidus-docs/deploys/5c2de220b7945d0008107d6c |
|
With that gem grouping change we should be able to only install the gems needed to build the current sub project. Currently we are always installing all gems for each subproject. I will prepare another PR to make the changes. |
Preparations for deploying the yard docs on Netlify.