Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 1d12c29

Browse files
authoredMay 12, 2024
Some polish and flair
1 parent ebca78c commit 1d12c29

File tree

2 files changed

+18
-7
lines changed

2 files changed

+18
-7
lines changed
 

‎articles/migrate_38.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,12 @@ Migrating from 3.8.0 should be straightforward for most platforms.
99

1010
The major difference is that 3.8.1 now requires .NET 6 and Visual Studio 2022. You can follow the [environment setup tutorial](getting_started/index.md) to make sure that you are not missing any components.
1111

12-
The MGCB Editor is no longer a global .NET tool and we recommend that you use the new Visual Studio 2022 extension which helps with accessing it without the need of CLI commands. It is also recommended that you uninstall the older global versions of the .NET tools as described below.
12+
The MGCB Editor is no longer a global .NET tool and we recommend that you use the new Visual Studio 2022 extension which helps with accessing it without the need of CLI commands.
13+
14+
15+
::: note
16+
It is also recommended that you uninstall the older global versions of the .NET tools as described below.
17+
:::
1318

1419
## WindowsDX, DesktopGL, and UWP
1520

@@ -30,16 +35,22 @@ Then edit your MonoGame ```PackageReference``` to point to 3.8.1:
3035

3136
### Accessing MGCB and MCGB Editor without a global tool
3237

33-
The MGCB Editor is no longer a .NET global tool, and doesn't need to be installed or registered. When migrating from 3.8.0, it is recommended that you uninstall the global versions of the tools. You can accomplish that with these commands:
38+
The MGCB Editor is no longer a .NET global tool, and does not need to be installed or registered. When migrating from 3.8.0, it is recommended that you **uninstall** the global versions of the tools. You can accomplish that with these commands:
3439

3540
```
3641
dotnet tool uninstall dotnet-mgcb -g
3742
dotnet tool uninstall dotnet-2mgfx -g
3843
dotnet tool uninstall dotnet-mgcb-editor -g
3944
```
45+
46+
::: tip
4047
**Do not** run the ``` dotnet tool install ``` on 3.8.1, as it would break 3.8.1.
48+
:::
49+
50+
You will also need to setup a dotnet-tools configuration file.
4151

42-
You will also need to setup a dotnet-tools configuration file. Next to your ```.csproj```, create a folder named ```.config``` and a file within it named ```dotnet-tools.json``` with this content:
52+
- Next to your ```.csproj```create a folder named ```.config```
53+
- Add a file within the folder named ```dotnet-tools.json``` with the following content:
4354

4455
```json
4556
{
@@ -80,7 +91,7 @@ You will also need to setup a dotnet-tools configuration file. Next to your ```.
8091
}
8192
```
8293

83-
Please note that you can't use the ```3.8.1.*``` wildcard in the ```dotnet-tools.json``` file (tool versions have to be fully qualified). We strongly recommand that the versions match the MonoGame version referenced in your ```.csproj``` (if you're using the ```*``` wildcard, make sure that they don't end up mismatching if the nugets are updated without you noticing).
94+
Please note that you cannot use the ```3.8.1.*``` wildcard in the ```dotnet-tools.json``` file (tool versions have to be fully qualified). We strongly recommand that the versions match the MonoGame version referenced in your ```.csproj``` (if you are using the ```*``` wildcard, make sure that they do not end up mismatching if the nugets are updated without you noticing).
8495

8596
You will also need to add this to your ```.csproj```:
8697

‎articles/whats_new.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: What's New
3-
description: What's new with the release of MonoGame 3.8.1
2+
title: Whats New
3+
description: Whats new with the release of MonoGame 3.8.1
44
---
55

6-
# What's New
6+
# Whats New
77

88
The MonoGame 3.8.1 release marks some big changes since 3.8.0 in how we build and distribute.
99

0 commit comments

Comments
 (0)
Please sign in to comment.