If we want to make it possible for internal_links to work inside CE and EE repos (https://gitlab.com/gitlab-com/gitlab-docs/issues/305), we need to change the workflow. This came up as a result of adding a global nav that has relative links to other top-level paths of the doc site. Previously, we did not allow any such relative links in the site. On Friday, December 7 `docs lint` was failing master for everyone. Marcia worked with Stan to diagnose/resolve. It was a delayed effect of having the new relative links in the new global nav, which fail the internal-links check. It took 10 days after the nav was merged for this to be an issue because our Docker image wasn’t rebuilt until Friday Dec 7, only due to unrelated work of another team. That day, Marcia/Axil/Stan worked on Temp fix - removing internal_links check https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/23665 Perm. fix - improving the check so it will work. https://gitlab.com/gitlab-com/gitlab-docs/issues/305 Preventative/process fix - Moving our dockerfile to our docs repo. https://gitlab.com/gitlab-com/gitlab-docs/issues/306 All related changes will be captured in this epic. ## Workflow This is for the gitlab-docs project: 1. Branch is pushed 1. Build starts 1. Internal links check starts in 5 parallel jobs, build cache is downloaded in all (can add as a dependency) 1. Test without providing a Nanoc environment (tests site with all products present) 1. Test each product separately (for example in CE: run `rm -r public/{ee,omnibus,runner}`, then check links based on env) 1. Tests pass 1. MR is merged 1. Temp Docker image is deleted (is there an API?) 1. New Docker lint image is created on master ## Todos **The following issues/MRs should be closed/implemented in that order:** 1. [x] Show the global nav only on the gitlab-docs project and locally https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/386 1. [ ] Create parallel jobs for internal links testing https://gitlab.com/gitlab-com/gitlab-docs/issues/308 1. [ ] Move the lint Dockerfile in this project https://gitlab.com/gitlab-com/gitlab-docs/issues/306 1. [ ] Sunset the existing Dockerfile from https://gitlab.com/gitlab-org/gitlab-build-images (don't remove the image, just the code that builds it) https://gitlab.com/gitlab-org/gitlab-build-images/merge_requests/151 1. [ ] Use new image for CE/EE/Omnibus/Runner `.gitlab-ci.yml`s