Skip to content

docs(kanvas): add Auto-pan on Drag and Render Modes advanced pages#949

Merged
hamza-mohd merged 6 commits intomasterfrom
docs/kanvas-autopan-render-modes
Apr 17, 2026
Merged

docs(kanvas): add Auto-pan on Drag and Render Modes advanced pages#949
hamza-mohd merged 6 commits intomasterfrom
docs/kanvas-autopan-render-modes

Conversation

@alexquincy
Copy link
Copy Markdown
Contributor

Summary

Two new advanced-topic pages for Kanvas under content/en/kanvas/advanced/:

  • Auto-pan on Drag (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.
  • Render Modes (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 server renders both new pages without errors.
  • Cross-references resolve (performance, url-parameters, tagsets pages).
  • Internal links between the two new pages render correctly.
  • Alert shortcodes render in expected styles.
  • Threshold table on the Render Modes page is readable on mobile.

- 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>
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 17, 2026

Deploy Preview for bejewelled-pegasus-b0ce81 ready!

Name Link
🔨 Latest commit 81d6170
🔍 Latest deploy log https://app.netlify.com/projects/bejewelled-pegasus-b0ce81/deploys/69e1afdb9104c90008200149
😎 Deploy Preview https://deploy-preview-949--bejewelled-pegasus-b0ce81.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread content/en/kanvas/advanced/autopan/index.md Outdated
Comment thread content/en/kanvas/advanced/autopan/index.md Outdated
Comment thread content/en/kanvas/advanced/render-modes/index.md Outdated
Comment thread content/en/kanvas/advanced/render-modes/index.md Outdated
Comment on lines +65 to +72
| **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.*
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The use of Unicode superscripts (¹, ², ³) for footnotes is non-standard in Markdown and may not render consistently across all platforms or be accessible to screen readers. It is recommended to use standard Markdown footnote syntax (e.g., [^1]) or simple numeric references in brackets (e.g., [1]).

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 17, 2026

PR Preview Action v1.6.3
Preview removed because the pull request was closed.
2026-04-17 04:25 UTC

alexquincy and others added 4 commits April 16, 2026 22:49
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>
@hamza-mohd
Copy link
Copy Markdown
Contributor

@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>
Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 17, 2026

@copilot resolve the merge conflicts in this pull request

Resolved in commit 81d6170. The add/add conflict in content/en/kanvas/advanced/render-modes/index.md was resolved by merging both versions — our PR's detailed technical content (feature size gate table, adaptive mode deep-dive with mode ladder/cooldowns/cheat sheet) combined with master's badge/SVG element specifics, Switching Render Modes section, Performance Guidance, Best Practices, Known Limitations, and Designer vs Operator sections.

Copilot AI requested a review from hamza-mohd April 17, 2026 03:59
@hamza-mohd hamza-mohd merged commit 1e160e2 into master Apr 17, 2026
8 checks passed
@hamza-mohd hamza-mohd deleted the docs/kanvas-autopan-render-modes branch April 17, 2026 04:25
alexquincy pushed a commit that referenced this pull request Apr 17, 2026
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants