Tutorial seemingly inconsistent with main docs on Shared folder

[escalonn]

This tutorial places the layout page, and some partials, in Pages/Shared folder, while the main documentation for Razor Pages says to put the layout page directly in Pages folder, and also says:
"We recommend you not put the layout file in the Views/Shared folder. Views/Shared is an MVC views pattern. Razor Pages are meant to rely on folder hierarchy, not path conventions."
Clarification in one place or the other is necessary.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: a25bf940-8977-fec4-461b-542a9f550fc8
• Version Independent ID: 5492c641-af15-64b8-beaa-ddf511be73e6
• Content: Get started with Razor Pages in ASP.NET Core
• Content Source: aspnetcore/tutorials/razor-pages/razor-pages-start.md
• Product: aspnet-core
• GitHub Login: @Rick-Anderson
• Microsoft Alias: riande

[guardrex]

Hi @escalonn ... Thanks for commenting. We're still working on 2.1 topic updates, so that's the reason for the discrepancy.

@Rick-Anderson Although this is marked for the Get started topic, it will actually be for updates to ...

https://docs.microsoft.com/aspnet/core/razor-pages#using-layouts-partials-templates-and-tag-helpers-with-razor-pages

[AndySmiffy]

So out of interest which is correct?

[guardrex]

• ASP.NET Core 2.0 Razor Pages: Pages
• ASP.NET Core 2.1 or later Razor Pages: Pages/Shared
• Mixed app of Razor Pages + MVC that uses a common layout page: We're waiting to hear back from engineering on what they suggest. See: Fix Pages/Shared layout in intro to RP #7336 (comment)

[Rick-Anderson]

We recommend you not put the layout file in the Views/Shared folder. Views/Shared is an MVC views pattern. Razor Pages are meant to rely on folder hierarchy, not path conventions.

That's all correct. You don't put Razor Pages layout files in the MVC Views/Shared folder

[Rick-Anderson]

hile the main documentation for Razor Pages says to put the layout page directly in Pages folder,

Where does it say that in the 2.1 version?

[elias-alea]

Just to add on to this, I created a 2.1 app and the _Layout.cshtml is under Pages/Shared.
Also, the _viewStart.cshtml looks like
@{
Layout = "_Layout";
}
will it still work while _ViewImports.cshtml declares the namespace as @namespace RazorPagesMovie.Pages?

[Rick-Anderson]

This doc was updated to correct Pages/shared