Simplify and consolidate local development environment setup docs
Goal
the Local Development Environment Setup docs should be completely self contained, and include all necessary instructions, commands, and config necessary to successfully set up GDK + Rancher Desktop to support exploratory testing of the Remote Development feature.
After completing the instructions, a developer should be able to create a workspace for the webide
editor, and successfully connect to it with the Web IDE.
Details
This is the documentation for setting up a Remote Development environment under a local GDK:
There are many steps to this complex process, and currently this document relies on linking out to several other places in the gitlab-agent
and GDK
documentation.
This is confusing, and it's very easy to get lost in all of the tabs, and not know which of the linked documentation is relevant to you or not.
Instead, we should update this documentation to be completely self-contained, and have every step clearly explained within this document itself
Even if it means duplicating information from the other documentation, this will be a much nicer experience for someone setting this up from scratch. We can still link out to the original documentation as a reference, and this will help us or users notice and report if they become out of sync for some reason.
And we will probably eventually want to deprecate this page anyway and move it to the real documentation site, and we'd probably want to perform a similar consolidation and cleanup at that point anyway.