Repository navigation
Practical tour
Language: English · Русский
The practical tour guides you through the real workflow without taking control of it:
Model → Diagnostics → Findings → Show or fix → Export report
It runs in a dockable pane on the right and presents the workflow as a compact checklist. The active task is highlighted, completed tasks have check marks, and the required panel is brought forward. A spotlight dims the surrounding panel and outlines and labels the next control without blocking it. When that control is a button, the button itself also gets an accent border, so a flat icon button stays visible on the dimmed panel. Closing the tour never runs a diagnostic, modifies a model, or applies a fix.
When the tour starts, the Diagnostics pane is brought forward and Revit Linter installs and refreshes the managed TOUR001 training collision check in the tour configuration subfolder. The check is pinned at the top of the Diagnostics pane and carries the Collision, Tour and Project tags in the Tags column; its selection is cleared. Type TOUR001 into the search box, narrow the list with the filters and clear the Document checkbox, then press Uncheck all, enable only this exact check, and use only its findings for the guided actions. Diagnostics run only with this single check enabled. It provides the visualizations and fix menu required by every task, independently of the user's own rules. Applying its fix completes the task and shows the result in the Fix list pane.
Finish the welcome window with Start or continue the practical tour selected. The panels open and the tour first points to the document button in the TOUR001 row, showing that every check is a YAML file you can copy and adapt.
Choose one of two paths:
- Select an official Autodesk sample found in the Samples folder of the running Revit version. Revit Linter creates a new disposable copy for every tour and opens it in the current Revit instance. Open tutorial on the Diagnostics tab remains available if automatic opening fails.
- Start the tour without a sample. It waits at Open a project or family and continues after you open a document yourself.
Only Autodesk samples for the running Revit version are offered. Your original sample is never opened as the working tutorial file.
Progress is kept separately for each Revit version.
- Continue later hides the tour pane and remembers the current step.
- Do not show again opts out for the running Revit version.
- Start over in the pane discards the saved step and restarts the tour from the first task.
- Opening or switching documents ends the tour, except while it waits for you to open a project or family. The pane hides and the step is remembered: use Practical tour on the Diagnostics tab to return.
- Use Practical tour on the Diagnostics tab to return to a saved step, or to start over after completion or opt-out. Open Getting started to configure the tour or reset its progress.
After running TOUR001, select one of its findings. The tour asks you to open the Show menu and choose “Isolate and inspect”, then open it again and choose “Cut and inspect”, then step to neighbouring findings with the previous and next arrows at the top of the report. Hover any control and press F1 while its tooltip is shown, or press the question-mark button in the selected report row, to open the documentation, then open the lightbulb menu and apply the fix. Then open the Fix list pane to see the applied fix, and select its row. Then ignore another finding from the same menu and open the Ignore list pane to see the ignored entry. Finally export the report and then export it once more, choosing a different format. Actions performed on findings from other checks do not advance these tasks.