# Example: .NET Framework 4 MVC screen document Doc gen produces one screen document per non-utility screen in a .NET Framework 4 ASP.NET MVC 5 front end that uses Razor views, written to `docs/screens/.md` from the controller action, its Razor view and its ViewModel. This is a different document from the [ASP.NET Core Razor Pages screen](ncore-screen.md) and the [BOF WebForms screen](frontend-screen.md): a screen is a compiled controller action that returns a full view, and its interface is actions and routes rather than page handlers or `.aspx` controls. ## What reviewers should check - **Screens are compiled actions that return a full view.** One document per `View()` action with a layout, not one per controller. Partial views, dialogs, grid, JSON and remote-validator actions are not screens, and `docs/screens/index.md` is reconciled against the compiled actions. - **The Route table uses the real route table.** The URL is what `RouteConfig` produces for the controller and action, not an invented path, with one row per verb when GET and POST share an action name. - **Operations use the MVC request form.** The `Request` column is `VERB Controller/Action`, without the `Controller` suffix. A `?handler=` request or a `[SecurityApiAuthorize]` role means the Razor Pages vocabulary leaked in, and a postback, `ViewState` or `.aspx` reference means the WebForms vocabulary did; both are defects. - **Access is the effective `[SaifAuthorize]` requirement.** The roles come from the action attribute, otherwise the controller's, otherwise the local `BaseController`'s, and each row names where it was declared. In-action checks such as `CanUserUpdate()` that change what the user sees are rows too. - **Delegation is sourced.** Every `Delegates to` value is a resolvable link to a library operation or application workflow, a `†`-marked dotted library name, or `—` for screen-local actions. The delegated operation's steps are not restated. - **Wiring stays off the screen page.** The Autofac composition root lives in the application companion project (here `SAIF.DependencyMaps.Web.PolicyRenewals`) and is documented on `docs/application/architecture.md`, not on screens. - **AJAX rows link to `hosted-endpoints.md`.** Each row in `## AJAX and grid actions` links its entry on `docs/application/hosted-endpoints.md`; partial views belong in `## Dialogs and partials`. - **Sources are controller, view and ViewModel files.** An `.aspx` file or a code-behind file as a source is a blocker. - **Rule IDs are links** to their anchor on `docs/application/business-rules.md`. - A `## Screen flow diagram` appears only when the screen has three or more outbound navigations. A cross-application target names the configuration key that holds its URL. ## Example The document below is a complete, correct `renewal-quote.md` for a fictional application. [View rendered example](rendered/screens/renewal-quote.md) — the same document as a real page, so you can compare rendering as well as source. ````markdown --- title: Renewal Quote summary: Lets underwriting staff review a policy's renewal premium by class code, adjust the quote lines, and issue the renewal offer to the employer. status: draft owner: Policy Renewals Team last_reviewed: 2026-09-09 --- # Renewal Quote Renewal Quote is the main working screen of the Policy Renewals application. Underwriting staff open it from the Renewal Queue for a policy that is approaching expiration and use it to review the quote the rating library has produced: the premium for each class code, the experience modifier, and the renewal effective date. The user can adjust individual premium lines, give a reason for the adjustment, save the quote, and issue the renewal offer to the employer. The action loads the quote for the `policyNumber` route value and returns a state view when none can be produced. From here the user returns to the queue, opens the quote history, or moves to the policy summary in the Policy Services Portal. ## Route | Controller | Action | Verb | URL | Parameters | View | Layout | | --- | --- | --- | --- | --- | --- | --- | | `RenewalController` | `Quote` | GET | `/Renewal/Quote/{policyNumber}` | `policyNumber` | `Views/Renewal/Quote.cshtml` | `_Layout` | | `RenewalController` | `Quote` | POST | `/Renewal/Quote/{policyNumber}` | `policyNumber`, `RenewalQuoteViewModel` | `Views/Renewal/Quote.cshtml` (redisplayed when validation fails) | `_Layout` | ## Access | Requirement | Declared on | Effect | | --- | --- | --- | | `[SaifAuthorize(Roles = "Renewals.Read,Renewals.Underwriting")]` | `BaseController` | Only users holding one of the two roles can open any action of a controller that derives from `BaseController` | | `[SaifAuthorize(Roles = "Renewals.Underwriting")]` | `RenewalController.IssueOffer` | Only underwriting staff can issue a renewal offer | | `CanUserUpdate()` | `RenewalController.Quote` | Returns `true` only for users in `Renewals.Underwriting`; when `false`, `IsReadOnly` is set, the grid shows no edit commands, and **Save quote** and **Issue offer** are hidden | ## Entry conditions - The user selects a policy in the Renewal Queue and follows the **Open quote** link, which passes `policyNumber` in the route. - The user opens a bookmarked or emailed URL of the form `/Renewal/Quote/{policyNumber}`. - The default route `Home/Index` redirects to the Renewal Queue, so the quote screen is never the application start page. - The action requires a policy number from the route or from `WebContext`. When neither supplies one, it returns the `InvalidContext` state view. ## Fields | Field | Binds to | Control | Purpose | Validation | | --- | --- | --- | --- | --- | | Policy number | `RenewalQuoteViewModel.PolicyNumber` | `Html.DisplayFor` | Identifies the policy being renewed | None; display only | | Employer | `RenewalQuoteViewModel.EmployerName` | `Html.DisplayFor` | Insured employer of record | None; display only | | Renewal effective date | `RenewalQuoteViewModel.EffectiveDate` | Kendo DatePicker (`Html.Kendo().DatePickerFor`) | Start of the renewal term | `[Required]` and `[Remote("ValidateEffectiveDate", "Renewal")]`; client-side yes | | Experience modifier | `RenewalQuoteViewModel.ExperienceModifier` | Kendo NumericTextBox (`Html.Kendo().NumericTextBoxFor`) | Modifier applied to the manual premium | `[Range(0.50, 2.50)]`; client-side yes | | Quote lines | `RenewalQuoteViewModel.QuoteLines` | Kendo Grid (`Html.Kendo().Grid()`) | Calculated and adjusted premium for each class code | `QuoteLineViewModelValidator` requires a non-negative adjusted premium; client-side no | | Adjustment reason | `RenewalQuoteViewModel.AdjustmentReason` | `Html.TextAreaFor` | Explains why any line differs from the calculated premium | `[StringLength(500)]`; required by `RenewalQuoteViewModelValidator` when a reduction exceeds 25 percent; client-side no | | Total premium | `RenewalQuoteViewModel.TotalPremium` | `Html.DisplayFor`, formatted as currency | Sum of the adjusted line premiums | None; display only | | Save quote | None | `