Skip to content

Add comprehensive Clone Mode Reference documentation#76

Open
kfarr wants to merge 2 commits intomainfrom
claude/expand-clone-docs-LLOQ5
Open

Add comprehensive Clone Mode Reference documentation#76
kfarr wants to merge 2 commits intomainfrom
claude/expand-clone-docs-LLOQ5

Conversation

@kfarr
Copy link
Contributor

@kfarr kfarr commented Feb 24, 2026

Summary

Added detailed documentation for the street-generated-clones component's four placement modes with visual diagrams, property tables, and use case guidance. Updated related documentation files to reference the new guide.

Key Changes

  • New document: docs/managed-street/clone-modes.md — comprehensive reference covering:

    • fixed mode: equal-spaced slots with centerpoint placement
    • random mode: shuffled grid positions with minimum spacing guarantee
    • single mode: one clone with justify-based positioning
    • fit mode: dimension-aware edge-to-edge tiling for buildings
    • Mode comparison table and selection guidance
    • ASCII diagrams illustrating placement behavior and spacing semantics
    • Property tables for each mode with descriptions
  • Updated: docs/managed-street/component-street-segment.md

    • Clarified that fit mode is the only dimension-aware mode
    • Corrected spacing definition (gap between edges, not centerpoints)
    • Added cross-reference to new Clone Mode Reference
    • Improved property descriptions for clarity
  • Updated: docs/managed-street/managed-street-json-format.md

    • Replaced inline mode descriptions with reference to Clone Mode Reference
    • Clarified spacing semantics for fixed and random modes
    • Improved mode descriptions with use case context
  • Updated: docs/managed-street/overview-managed-street.md

    • Added Clone Mode Reference to navigation sidebar

Notable Details

  • Documentation distinguishes between centerpoint spacing (fixed, random) and edge-to-edge spacing (fit)
  • Includes caution about using random mode with buildings (dimension-unaware placement)
  • Provides practical examples for each mode with realistic model arrays
  • Visual ASCII diagrams show how models are positioned relative to spacing parameters

https://claude.ai/code/session_01WCrEmcJ4vwoPJimGdKgpdv

New dedicated page documenting all four street-generated-clones
placement modes (fixed, random, single, fit) with ASCII diagrams,
property tables, usage examples, and a comparison table. Addresses
contributor confusion about mode differences, especially between
random (centerpoint-based) and fit (dimension-aware edge-to-edge)
placement. Cross-references added from existing docs.

https://claude.ai/code/session_01WCrEmcJ4vwoPJimGdKgpdv
@netlify
Copy link

netlify bot commented Feb 24, 2026

Deploy Preview for 3dstreet-dot-com ready!

Name Link
🔨 Latest commit 4225a92
🔍 Latest deploy log https://app.netlify.com/projects/3dstreet-dot-com/deploys/699d11170a9f870008960cbe
😎 Deploy Preview https://deploy-preview-76--3dstreet-dot-com.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.

@netlify
Copy link

netlify bot commented Feb 24, 2026

Deploy Preview for 3dstreet-docs-build-preview ready!

Name Link
🔨 Latest commit 4225a92
🔍 Latest deploy log https://app.netlify.com/projects/3dstreet-docs-build-preview/deploys/699d1117d0660b000725267f
😎 Deploy Preview https://deploy-preview-76--3dstreet-docs-build-preview.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.

- Explain that fixed and random share the same grid; fixed fills all
  slots while random fills a subset. Both randomly select models.
- Add "How fixed and random relate" comparison section
- Broaden fit mode language to reference walls, fences, seawalls
  alongside buildings
- Remove building-specific caution callout

https://claude.ai/code/session_01WCrEmcJ4vwoPJimGdKgpdv
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants