Some info that Mario is presenting in his article https://developers.redhat.com/articles/2022/07/12/how-run-vs-code-openshift-dev-spaces# is missing from the docs.

Suggested course of action:

1. Review Mario's article and identify all missing info.

2. Add the missing info into the docs.

3. Test the updated procedures.

Type Bug because i tried the currently published procedure and it didn't work for me.

To-do:

https://www.eclipse.org/che/docs/stable/end-user-guide/specifying-an-in-browser-ide-for-a-git-repository-by-using-che-editor/#using-the-che-prod-editor-file-to-select-an-ide_che

1. Rewrite steps 1 and 2, possibly as one single step.
2. The step about starting the workspace is missing, so it's not clear when (in relation to starting a new workspace) the other steps are to be performed.
3. Link to the `id` column in the Table: Supported in-browser IDEs in https://www.eclipse.org/che/docs/stable/end-user-guide/selecting-a-workspace-ide/ .
4. The first ul item in .Additional resources is to be dropped.
5. The second ul item in .Additional resources is to be moved to .Additional resources to the next con/ref section.

https://www.eclipse.org/che/docs/stable/end-user-guide/specifying-an-in-browser-ide-for-a-git-repository-by-using-che-editor/#customizing-ide-selection-with-the-che-editor-file_che

most likely has to be deleted, although currently it should be turned into a higher-level assembly for

• https://www.eclipse.org/che/docs/stable/end-user-guide/specifying-an-in-browser-ide-for-a-git-repository-by-using-che-editor/#using-a-custom-plug-in-registry-for-your-ide_che
• https://www.eclipse.org/che/docs/stable/end-user-guide/specifying-an-in-browser-ide-for-a-git-repository-by-using-che-editor/#using-a-web-reference-for-your-ide_che
• https://www.eclipse.org/che/docs/stable/end-user-guide/specifying-an-in-browser-ide-for-a-git-repository-by-using-che-editor/#using-an-embedded-editor-ddefinition-for-your-ide_che

The following three sections, which currently procedures, most likely need to be rewritten as one single reference module:

• https://www.eclipse.org/che/docs/stable/end-user-guide/specifying-an-in-browser-ide-for-a-git-repository-by-using-che-editor/#using-a-custom-plug-in-registry-for-your-ide_che
• https://www.eclipse.org/che/docs/stable/end-user-guide/specifying-an-in-browser-ide-for-a-git-repository-by-using-che-editor/#using-a-web-reference-for-your-ide_che
• https://www.eclipse.org/che/docs/stable/end-user-guide/specifying-an-in-browser-ide-for-a-git-repository-by-using-che-editor/#using-an-embedded-editor-ddefinition-for-your-ide_che

https://github.com/eclipse-che/che-plugin-registry/blob/main/che-editors.yaml in .Additional resources is an upstream-only link. It needs to be examplified and a downstream alternative found and provided