Skip to content

New "Getting Started" tutorial - #326

Merged
SimonDarksideJ merged 4 commits into
mainfrom
feature/gettingstarted-mk2
Nov 5, 2026
Merged

SimonDarksideJ merged 4 commits into
mainfrom
feature/gettingstarted-mk2

Conversation

@SimonDarksideJ

Copy link
Copy Markdown
Collaborator

Summary

Add the new "Getting Started" guide and deprecated (but not removed) the original guide for SEO.
Now covers the new "Empty Game" (Single Project) template and the Content Builder.

P.S. Borrowed the formating from the awesome 2D tutorial.

…the original guide for SEO.

Now covers the new "Empty Game" (Single Project) template and the Content Builder
@tomspilman

Copy link
Copy Markdown
Member

These are my concerns here:

  1. If the old tutorial content shouldn't be used... we should delete that content and leave only the link to the new content. To be absolutely clear... i mean delete the content of the files... they files stay to serve old links. Just dropping a warning at the top of the old content suggests the old content is still valid.
image
  1. We need to avoid duplicating content. Our docs like to repeat the same link 2 or 3 times within 200 or so words then also give you a good chunk of the content within that link. People are not blind... we don't need to repeat the same link multiple times on the same page and we certainly do not want to duplicate content as it leads to problems maintaining the docs.
image
  1. The structure is very often hard to follow. The toc is duplicated within the page along with additional content which overwhelms to viewer and makes it hard to understand where to begin.
image

Overall the content of the docs/tutorial/guides are good. The issue is it needs a technical editor to fix the presentation of the content.

@SimonDarksideJ

SimonDarksideJ commented Nov 5, 2026 •

Copy link
Copy Markdown
Collaborator Author
  1. If the old tutorial content shouldn't be used... we should delete that content and leave only the link to the new content. To be absolutely clear... i mean delete the content of the files... they files stay to serve old links. Just dropping a warning at the top of the old content suggests the old content is still valid.

Investigating, may need to be a separate PR later

  1. We need to avoid duplicating content. Our docs like to repeat the same link 2 or 3 times within 200 or so words then also give you a good chunk of the content within that link. People are not blind... we don't need to repeat the same link multiple times on the same page and we certainly do not want to duplicate content as it leads to problems maintaining the docs.

Sorted

  1. The structure is very often hard to follow. The toc is duplicated within the page along with additional content which overwhelms to viewer and makes it hard to understand where to begin.

Updated the headers to be clearer, for the rest we will address that in the larger review

@SimonDarksideJ
SimonDarksideJ merged commit 8990912 into main Nov 5, 2026
2 checks passed
@SimonDarksideJ
SimonDarksideJ deleted the feature/gettingstarted-mk2 branch November 5, 2026 17:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants