Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adds a Getting Started Article for VSCode #18

Merged
merged 18 commits into from
Jun 13, 2024

Conversation

AristurtleDev
Copy link
Contributor

Description

This PR adds a getting started article for setting up a development environment for to use MonoGame with VSCode. The article contains instructions for Windows, macOS, and Linux, each separated using the tabs feature.

Live Preview

A live preview of the article can be found at https://mgdocs.aristurtle.net/articles/getting_started/1_setting_up_your_development_environment_vscode.html

References

Issue MonoGame/docs.monogame.github.io#5: feature request: Add Getting started with VS Code article

@SimonDarksideJ SimonDarksideJ changed the base branch from main to feature/docsmigration May 29, 2024 11:28
@SimonDarksideJ SimonDarksideJ changed the base branch from feature/docsmigration to main May 29, 2024 11:28
@SimonDarksideJ
Copy link
Collaborator

PR failing @AristurtleDev ?

Copy link
Collaborator

@SimonDarksideJ SimonDarksideJ left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few comments.

  • Needs an "Overview" section at the top, like a TOC, to give a high level overview of the process
  • I don't think the VSCode Extensions setup needs all three platforms, as VSCOde makes this the same for all platforms (could not see any differences in your writeup)
  • For sections that ONLY apply to Mac/Linux, please state that in the header, e.g "Setup Wine For Effect Compilation - MacOS/Linux only)
  • Apple Silicon also needs a note about installing both x64 and x86 workloads, as well as paths and environment settings setup. And try not to assume any knowledge about Macs (I was a first time user setting up my Mac for MonoGame and it was MANY tutorials before I found the secret sauce)
  • Needs a summary for what the reader should have by the end of the guide, as well as the existing link for "where to go next"

@AristurtleDev
Copy link
Contributor Author

Apple Silicon also needs a note about installing both x64 and x86 workloads, as well as paths and environment settings setup. And try not to assume any knowledge about Macs (I was a first time user setting up my Mac for MonoGame and it was MANY tutorials before I found the secret sauce)

I've asked @dellis1972 if he can update the document with his known fix of using <DotnetCommand>. Or if he can dm me the information I can update that section.

Copy link
Contributor Author

@AristurtleDev AristurtleDev left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @dellis1972

@AristurtleDev
Copy link
Contributor Author

Should be good for review now @SimonDarksideJ

SimonDarksideJ
SimonDarksideJ previously approved these changes Jun 13, 2024
Copy link
Collaborator

@SimonDarksideJ SimonDarksideJ left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I abore this change for windows, but ok then :D

@SimonDarksideJ SimonDarksideJ merged commit 7b76a86 into MonoGame:main Jun 13, 2024
2 checks passed
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.

None yet

3 participants