Skip to content

NUR 2 Workflow

NUR is a presentation layer over QLens canonical records. It must not become a second source of truth.

Regenerate workspace pages

qlens render

Or run the complete pipeline:

qlens build

Serve locally

mkdocs serve

MkDocs watches documentation files and rebuilds the site when they change. When canonical research objects change, run qlens build again before relying on generated workspace pages.

Strict production build

mkdocs build --strict

The static site is written to site/ by default.

Clean rebuild

Linux/macOS:

rm -rf site docs/workspace
qlens build
mkdocs build --strict

Windows PowerShell:

Remove-Item -Recurse -Force site, docs\workspace -ErrorAction SilentlyContinue
qlens build
mkdocs build --strict

What NUR renders

  • Research Space dashboards
  • canonical object summaries
  • metadata cards
  • outgoing links and backlinks
  • graph views
  • timeline views
  • status and object-type indicators

Presentation boundary

Editing generated files under docs/workspace/ is not a durable change. The next qlens render or qlens build may replace them. Edit canonical objects or NUR renderer code instead.