diff --git a/README.md b/README.md index 907f296..a5c63ae 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,13 @@ # eShopOnWeb -Sample ASP.NET Core reference application, powered by Microsoft, demonstrating a monolithic application architecture and deployment model. This reference application is meant to support the [Architecting and Developing Modern Web Applications with ASP.NET Core and Azure eBook](https://aka.ms/webappebook) +Sample ASP.NET Core reference application, powered by Microsoft, demonstrating a single-process (monolithic) application architecture and deployment model. This reference application is meant to support the [Architecting Modern Web Applications with ASP.NET Core and Azure eBook](https://aka.ms/webappebook) -The **eShopOnWeb** is related to the [eShopOnContainers](https://github.com/dotnet/eShopOnContainers) sample application which, in that case, focuses on a microservices/containers based application architecture. However, **eShopOnWeb** is much simpler in regards its current functionality and focuses on traditional Web Application Development with a single monolithic deployment, no microservices/containers related. +The **eShopOnWeb** sample is related to the [eShopOnContainers](https://github.com/dotnet/eShopOnContainers) sample application which, in that case, focuses on a microservices/containers-based application architecture. However, **eShopOnWeb** is much simpler in regards to its current functionality and focuses on traditional Web Application Development with a single deployment. + +The goal for this sample is to demonstrate some of the principles and patterns described in the [eBook](https://aka.ms/webappebook). It is not meant to be an eCommerce reference application, and as such it does not implement many features that would be obvious and/or essential to a real eCommerce application. > ### DISCLAIMER -> **IMPORTANT:** The current state of this sample application is **ALPHA**, consider it a 0.1 foundational version. Therefore areas will change significantly while refactoring current code and implementing new features. **Feedback with improvements and pull requests from the community are highly appreciated and accepted.** Planned features for this sample include user registration, login, shopping cart management, and checkout. +> **IMPORTANT:** The current state of this sample application is **BETA**, consider it a 0.5 version, open to community feedback and contributions. Some areas will continue to evolve and change while refactoring continues. **Feedback with improvements and pull requests from the community are highly appreciated and accepted.** ## Topics (eBook TOC) @@ -23,7 +25,9 @@ The **eShopOnWeb** is related to the [eShopOnContainers](https://github.com/dotn ## Running the sample -After cloning or downloading the sample you will need to run its Entity Framework Core migrations before you will be able to run the app. To do so, open a command prompt in the Web folder and execute the following commands: +After cloning or downloading the sample you should be able to run it using an In Memory database immediately. + +If you wish to use the sample with a persistent database, you will need to run its Entity Framework Core migrations before you will be able to run the app. To do so, open a command prompt in the Web folder and execute the following commands: ``` dotnet restore diff --git a/docs/Architecting Modern Web Applications with ASP.NET Core and Azure.pdf b/docs/Architecting Modern Web Applications with ASP.NET Core and Azure.pdf index d3c4786..ba0e9cd 100644 Binary files a/docs/Architecting Modern Web Applications with ASP.NET Core and Azure.pdf and b/docs/Architecting Modern Web Applications with ASP.NET Core and Azure.pdf differ