Overhaul of Game Studio and new Scenes section

[ferafiks]

Preamble

I'm creating this draft PR, as properly describing all of the changes will be an effort of its own. It will probably take a few weeks or months before everything gets finished.

Description

A full overhaul of the Game Studio section, replacing all pages with new ones and moving old content to better places.

Related issues

• Closes Rewrite of Game Studio #525
• Closes Mention the option to reset the Game Studio layout #493
• Partially addresses chore: Remove all Xenko / unlinked images #349

Where is the old content?

• Game Studio/Assets was rewritten and moved to a new category outside of Game Studio in New "Assets" section #501
• Game Studio/Scenes was rewritten and moved to a new category outside of Game Studio named Scenes
• Game Studio/Prefabs was moved to the new Scenes category (Scenes/Prefabs)
• Game Studio/Game Settings was rewritten and moved to Project/Game Settings
• Game Studio/World Units was rewritten and moved to Scenes/Entities/Transform/World Units

New content

• New Themes page
• New Game Studio/Panels section containing information related to all built-in panels
• New Game Studio/Dedicated editors section containing information related to all built-in dedicated editors
• New Game Studio/Settings page
• New Scenes/Sub-scenes page
• New Scenes/Structuring scenes page, also now containing information about scene folders
• New Scenes/Entities page
• New Scenes/Entities/Components page
• New Scenes/Entities/Transform page
• New Matrices page
• New content added to Glossary

Removed content

• Removed old videos and gifs - there are a few reasons behind this:
  • It's a lot harder to replace old videos as opposed to screenshots
  • Harder to maintain
  • Not available in PDF versions
• Removed information about game settings overrides - currently these are partially broken, generally useless and might be removed in the future (fix: Game settings config overrides not working properly stride#3272)

Changes

Important

These are WIP screenshots. Do not use them for review, as most content will probably change.

Game Studio

The section was overhauled from the ground-up. Previously, most pages under it didn't make sense to be there and a lot of actual editor-related content was missing. I'm gonna go over the most notable changes one by one:

The Layout page shows instructions on how to rearrange panels in Game Studio and how its layout generally works.

The Panels section contains a page for every panel built-into Game Studio. Most pages contain most of the features of all panels. The only outlier here is Asset errors, as I simply ran out of energy while testing. For now I don't think it's that big of an issue and we can always add actual content to it in the future.

For Dedicated editors I kept most of the information fairly short, only focusing on showcasing all features that an editor has and pointing users to the appropriate sections for further reading. The only outlier here is the Scene editor, as its the most complex editor and I'm guessing a lot of users will look for content about it in its page. A large chunk of the Viewport text is shared between that page and Edit a scene.

Settings is mostly inspired by a similar page from Flax's docs (link) providing additional descriptions for all options and making it a bit easier to find what you're looking for.

Themes is meant to showcase all available themes, to make it a bit easier to see what you are picking without having to reload the entire editor. It's kept in its own folder so that if in the future user themes will become a thing, we will have a place for new pages related to creating, installing and sharing.

Scenes

Pages available in the root mimic some of the content from the previous Game Studio/Scenes, adding more information about sub-scenes, how to structure scenes, how to load scenes and general scene editing.

Prefabs is mostly kept the same, mostly updating some of the screenshots and modifying text to be more consistent across other recently refreshed pages.

Entities adds the very important, but previously missing information related to creating entities at runtime, adding them to a scene and removing them.

Components also adds the very important, but previously missing content related to managing components in code.

Transform is another one of those pages with very important, but previously missing information. It describes how to work with transforms in code. Some of the information is... ridiculous (such as setting the world scale), but that's just how Stride works :P. Maybe I'll make a PR on the main repo to add some utilities to take care of this, but I'm still not sure how to do that without breaking previous API. Still, that's probably a conversation for another time.

Types of rotation is meant to showcase the different ways of managing rotation of an object (quaternions vs euler angles).

Matrices isn't a page about matrices in general, nor the Matrix class, but just about how to use the local and world matrix in code. Matrices serve a big role in Stride, providing direction and world values, so I felt it was important enough to create a separate page just for them. Writing this was slightly out of my comfort zone. Let me know if I committed any mathematical or logical war-crimes.

World units is exactly what you would think, except that now we also have rotation units.

TODO

• Write content
• Take screenshots
  • Game Studio (root)
  • Panels
  • Dedicated editors
  • Scenes (root)
  • Prefabs
  • Entities
• Create visualizations
• Update glossary
• Polish content
• Review content