Skip to content

Commit 98e8985

Browse files
Sofie Toft Kristensengitbook-bot
authored andcommitted
GITBOOK-60: Fixes based on Feedback
1 parent 37875cf commit 98e8985

File tree

4 files changed

+12
-11
lines changed

4 files changed

+12
-11
lines changed

15/umbraco-cms/fundamentals/setup/install/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,15 @@ description: Instructions on installing Umbraco on various platforms using vario
44

55
# Installation
66

7+
## Install the latest .NET SDK
8+
9+
Before you install Umbraco, you must ensure that you can run it on your machine.
10+
11+
* Identify and install the latest [.NET SDK](https://dotnet.microsoft.com/download).
12+
713
## Install Umbraco using CLI
814

9-
The fastest way to get the latest version of Umbraco up and running is using the command line (CLI).
15+
The fastest way to get the latest version of Umbraco up and running is by using the command line (CLI).
1016

1117
1. Open your command line.
1218
2. Install the Umbraco templates:
@@ -52,7 +58,7 @@ Members of the Umbraco Community have created a website that makes the installat
5258

5359
## Alternative Methods for Installing Umbraco
5460

55-
There are numerous ways to install Umbraco. Below, you can find links to different installation methods that will help you easily install and set up Umbraco projects. 
61+
There are numerous ways to install Umbraco. Below, you can find links to different installation methods that will help you easily install and set up Umbraco projects.
5662

5763
### [.NET CLI installation](install-umbraco-with-templates.md)
5864

15/umbraco-cms/tutorials/creating-a-basic-website/creating-master-template-part-2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ We will now create a page to display our contact details. For added functionalit
66

77
Here are some potential solutions:
88

9-
* **Use Umbraco Forms (for non-developers):** Umbraco offers an add-on called Umbraco Forms. This tool is ideal for users who aren’t programmers, as it allows editors to create custom forms. You can find more information and purchase the product on [Umbraco.com](https://umbraco.com/products/umbraco-forms/).
9+
* **Use Umbraco Forms (for non-developers):** Umbraco offers an add-on called Umbraco Forms. This tool is ideal for users who aren’t programmers, as it allows editors to create custom forms. You can find more information and purchase the product on [Umbraco.com](https://umbraco.com/products/add-ons/forms/).
1010
* **Build Your Own Contact Form (for developers):** If you prefer a custom solution, you can build your own contact form using [Surface Controllers](../../fundamentals/code/creating-forms.md) in Umbraco.
1111

1212
### Creating the Document Type and Template

15/umbraco-cms/tutorials/creating-a-property-editor/custom-value-conversion-for-rendering.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,4 +75,4 @@ public class MySuggestionsModel
7575
We have used the property type editor UI alias from `umbraco-package.json` in the implementation of `IsConverter()`.
7676
{% endhint %}
7777

78-
For more advanced Property Value Converter techniques (for example, controlling caching), see the [Property Value Converters](https://docs.umbraco.com/umbraco-cms/extending/property-editors/property-value-converters) article.
78+
For more advanced Property Value Converter techniques (for example, controlling caching), see the [Property Value Converters](../../customizing/property-editors/property-value-converters.md) article.

15/umbraco-cms/tutorials/getting-started-with-entity-framework-core.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ You need to be aware of some things if you are using EF Core, and have installed
3939

4040
* This package has a transient dependency to `Microsoft.CodeAnalysis.Common` which clashes with the same transient dependency from `Umbraco.Cms 13.0.0`. This happens because `Microsoft.EntityFrameworkCore.Design 8.0.0` requires `Microsoft.CodeAnalysis.CSharp.Workspaces` in v4.5.0 or higher.
4141
* If there are no other dependencies that need that package then it installs it in the lowest allowed version (4.5.0). That package then has a strict dependency on `Microsoft.CodeAnalysis.Common` version 4.5.0. The problem is `Umbraco.Cms` through its own transient dependencies that require the version of `Microsoft.CodeAnalysis.Common` to be >= 4.8.0.
42-
* This can be fixed by installing `Microsoft.CodeAnalysis.CSharp.Workspaces` version 4.8.0 as a specific package instead of leaving it as a transient dependency. This is because it will then have a strict transient dependency on `Microsoft.CodeAnalysis.Common` version 4.8.0, which is the same that Umbraco has.
42+
* This can be fixed by installing `Microsoft.CodeAnalysis.CSharp.Workspaces` version 4.10.0 as a specific package instead of leaving it as a transient dependency. This is because it will then have a strict transient dependency on `Microsoft.CodeAnalysis.Common` version 4.8.0, which is the same that Umbraco has.
4343

4444
</details>
4545

@@ -136,7 +136,6 @@ builder.Services.AddUmbracoDbContext<BlogContext>(options =>
136136
We can then access the database via the `BlogContext.` First, we need to migrate the database to add our tables. With EFCore, we can autogenerate the migrations with the terminal.
137137

138138
{% hint style="info" %}
139-
140139
For package developers and not only, but in general as well, it's recommended to use the `UseUmbracoDatabaseProvider` logic. This is because it will then figure out what the correct database is used:
141140

142141
```csharp
@@ -145,11 +144,10 @@ builder.Services.AddUmbracoDbContext<CustomDbContext>((serviceProvider, options)
145144
options.UseUmbracoDatabaseProvider(serviceProvider);
146145
});
147146
```
148-
149147
{% endhint %}
150148

151149
2. Open your terminal and navigate to your project folder.
152-
3. Generate the migration by running:&#x20;
150+
3. Generate the migration by running:
153151

154152
```bash
155153
dotnet ef migrations add InitialCreate --context BlogContext
@@ -164,7 +162,6 @@ If you use another class library in your project to store models and DBContext c
164162
```bash
165163
dotnet ef migrations add initialCreate -s ../Project.Web/ --context BlogContext
166164
```
167-
168165
{% endhint %}
169166

170167
In this example, we have named the migration `InitialCreate`. However, you can choose the name you like.
@@ -243,9 +240,7 @@ To create, read, update, or delete data from your custom database tables, use th
243240
The example below creates a `UmbracoApiController` to be able to fetch and insert blog comments in a custom database table.
244241

245242
{% hint style="warning" %}
246-
247243
* This example uses the `BlogComment` class, which is a database model. The recommended approach would be to map these over to a ViewModel instead, that way your database & UI layers are not coupled. Be aware that things like error handling and data validation have been omitted for brevity.
248-
249244
{% endhint %}
250245

251246
```csharp

0 commit comments

Comments
 (0)