docs(kanvas): add Auto-pan on Drag and Render Modes advanced pages#949
docs(kanvas): add Auto-pan on Drag and Render Modes advanced pages#949hamza-mohd merged 6 commits intomasterfrom
Conversation
- content/en/kanvas/advanced/autopan/index.md — describes autopan's usefulness in large designs, the Options-panel toggle, the per-render- mode size thresholds, and advanced performance considerations (listener fan-out, bidirectional reactivity, tuning levers). - content/en/kanvas/advanced/render-modes/index.md — full description of Full / Medium / Wireframe / View-Only, the feature-size-gate table across render modes, and a robust walkthrough of Adaptive Render Mode (ceiling, mode ladder, signals, cooldowns, when to use vs. turn off). Both pages cross-link to each other and to the existing Performance and URL-parameter pages. Signed-off-by: Lee Calcote <lee.calcote@layer5.io>
✅ Deploy Preview for bejewelled-pegasus-b0ce81 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Code Review
This pull request introduces comprehensive documentation for the Auto-pan on Drag feature and the various Render Modes in Kanvas, including details on performance gates and adaptive rendering logic. The review feedback identifies opportunities to improve consistency by standardizing on American English spelling and enhancing accessibility by replacing non-standard Unicode superscripts with standard Markdown footnote syntax.
| | **Layout animation** | 100 | —¹ | —¹ | —¹ | Animated layouts only run in Full mode with ≤100 edges. | | ||
| | **TagSet visual grouping** | 20² | 20² | 20² | 20² | TagSets display auto-disables past 20 tags; re-enable via **Group Components** in the dock. | | ||
| | **Feasibility evaluation** | zoom-gated³ | zoom-gated³ | zoom-gated³ | zoom-gated³ | Gated on zoom, not size — hidden when you zoom out past the detail threshold. | | ||
| | **Component style editing** | zoom-gated³ | zoom-gated³ | zoom-gated³ | zoom-gated³ | Same: revealed only at detailed zoom levels. | | ||
|
|
||
| ¹ *Layout animation is a Full-mode-only feature by design. Kanvas falls back to instant (unanimated) layouts in other modes, so the per-mode threshold doesn't apply.* | ||
| ² *TagSet threshold is tag count, not node count. See [Working with Tags](/kanvas/designer/tagsets/).* | ||
| ³ *Zoom-gated features activate when your zoom level is above `MIN_ZOOM_FOR_DETAILED_RENDERING`. Zooming out suppresses them regardless of render mode.* |
There was a problem hiding this comment.
|
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Signed-off-by: Alex Quinn <227241865+alexquincy@users.noreply.github.com>
|
@copilot resolve the merge conflicts in this pull request |
Resolve add/add conflict in content/en/kanvas/advanced/render-modes/index.md by merging detailed technical content from both branches: - Keep PR's detailed render mode descriptions, feature size gate table, adaptive render mode deep-dive, cheat sheet, and related pages - Incorporate master's badge/SVG specifics, Switching Render Modes section, Performance Guidance, Best Practices, Known Limitations, and Designer vs Operator sections Signed-off-by: GitHub <noreply@github.com> Co-authored-by: hamza-mohd <135669921+hamza-mohd@users.noreply.github.com>
Resolved in commit |
Resolve conflicts in content/en/kanvas/advanced/performance/index.md, package.json, and package-lock.json. For performance/index.md: drop the duplicated "Special URL Options for Performance" section (already covered comprehensively in the new render-modes page added in #949) in favor of a concise cross-reference block pointing to Render Modes, Auto-pan on Drag, and Design Render Quality. Add a "Related performance controls" callout near the top of "What Affects Performance" and cross-link to Auto-pan on Drag from the grouped-components drag guidance so readers can find the per-mode thresholds without duplicating them here. For package.json: take the newest of each dependency (autoprefixer ^10.4.23, hugo-extended 0.158.0, postcss ^8.5.6, postcss-cli ^11.0.1) and regenerate package-lock.json. Signed-off-by: Lee Calcote <lee.calcote@layer5.io>
Summary
Two new advanced-topic pages for Kanvas under
content/en/kanvas/advanced/:advanced/autopan/) — describes the feature's purpose in large designs, how to toggle it from the Options panel, the per-render-mode size thresholds, and a deep dive into the listener-fan-out performance model with tuning guidance.advanced/render-modes/) — full description of Full, Medium, Wireframe, and View-Only, a cross-mode feature-size-gate table, and a robust walkthrough of Adaptive Render Mode (ceiling, mode ladder, signals, downshift/upshift thresholds, cooldowns, when to use vs. turn off).Both pages cross-link to each other and to the existing Performance Limits and Tuning and Design Render Quality pages.
Companion to meshery-extensions#4163, which lands the implementation (Options-panel toggle, per-mode thresholds, bidirectional reactive gate).
Test plan
hugo serverrenders both new pages without errors.