"Getting Started" guide feedback

[ocornut]

Please use this topic to comment on the https://github.com/ocornut/imgui/wiki/Getting-Started page

[KenniBlank]

The Getting-Started Wiki is very confusing. I think that just base installation should be moved to different section and other examples should be linked at end.

I opened the wiki, and got confused.

1. The section game_loop, compiling/linking being before the Setting Up felt like a wall.
2. The setting up section feels so confusing to getting started with installation: branch part is in compiling/linking. The instructions felt so unclear, it would be nice if there was just step-by-step verbose guide rather that this.

Just getting started feels like a headache, so that section should be crystal clear.

Example Getting Started:
1.1 Installation (Step-by-step)
1.2 First example (Very simple one)
1.3 How it works
1.4 Links to other specific examples.

That is it for my 2 cents. Maybe this is an issue for me only.

[ocornut]

Thank you for your feedback!

I have added a "Checking Out" section above "Compiling/Linking", moved two steps there, and made minor amends.
But otherwise I am not sure what precisely to do better.

My guess is that the 9 points list in "Setting up Dear ImGui & Backends" is mostly noise, and it is better to simply read any "Example: if you are using XXX" section. Maybe I should remove this section completely?

[Scylardor]

The "What is a Game Loop?" link in the Index is broken because the right anchor to use should be #what-is-a-game-loop, not #what-is-game-loop.
It's just a simple typo to fix, but right now when one clicks on the link, nothing happens.

[DouglasPotesta]

The setup guide shows you how to create a context, but it never uses SetCurrentContext. I know it’s technically not necessary for the first context you make, but it is an easy pitfall to forget to use it for a subsequent context.