Skip to content

Commit

Permalink
add redirect info
Browse files Browse the repository at this point in the history
  • Loading branch information
tdykstra authored Dec 9, 2016
1 parent 2ac2789 commit 25b094c
Showing 1 changed file with 12 additions and 0 deletions.
12 changes: 12 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,18 @@ DocFX requires the .NET Framework on Windows, or Mono for Linux or macOS.

* Run **docfx** in the `Docs\aspnetcore` directory to build the site, and **docfx-serve** to view the site at `http://localhost:8080`.

## Redirects

If you delete an article, change its file name, or move it to a different folder, create a redirect so that people who bookmarked the article won't get 404s. To seet up a redirect, create a file that has the redirect target URL as shown below, and put it in the original file's location.

```
---
redirect_url: /aspnet/core/location-of-target-for-redirect
---
```

For an example, see the [redirect file](https://github.com/aspnet/Docs/blob/master/aspnetcore/security/authentication/sociallogins.md) that redirects `/security/authentication/sociallogins` to `/security/authentication/social/index`.

## Voice and tone

Our goal is to write documentation that is easily understandable by the widest possible audience. To that end we have established guidelines for writing style that we ask our contributors to follow. For more information, see [Voice and tone guidelines](https://github.com/dotnet/docs/blob/master/styleguide/voice-tone.md) in the .NET Core repo.

0 comments on commit 25b094c

Please sign in to comment.