Docs: add documentation for partial bins feature#123
Conversation
jasonmadigan
left a comment
jasonmadigan
left a comment
There was a problem hiding this comment.
thanks for writing these up @gr3enk, the stl-generation section especially is really thorough and technically accurate. a few small style tweaks to match the existing docs and this is good to merge.
| - Half-grid base (21mm cells for finer baseplate positioning) | ||
| - Insert mode (contrast insert with configurable height) | ||
| - Bed size for auto-splitting large bins | ||
| - Partial bins (disabled specific parts of the bin to save filament) |
There was a problem hiding this comment.
suggestion: "disabled" should be "disable" (verb form), and the existing feature lines in this list are factual without rationale -- e.g. "Bed size for auto-splitting large bins". could trim to something like:
- Partial bins (disable individual grid cells to reduce print volume)
There was a problem hiding this comment.
disabled was just a typo as well 😬. I didn't like the wording with filament myself either. reduce print volume is definitely better.
|
|
||
| **Contrast insert** -- generates a separate STL to print in a different colour. The pocket is deepened automatically to accommodate the insert thickness. | ||
|
|
||
| **Partial Bins** -- allows you to disable individual parts of the Gridfinity box to save filament. |
There was a problem hiding this comment.
suggestion: the existing toggle descriptions in this section use bold-dash factual format, e.g. "Magnet holes -- recesses in the bin base...". the new ones use a different style ("allows you to", "This is an additional feature for"). worth matching the existing pattern for consistency, e.g.:
**Partial Bins** -- disables individual grid cells, removing them from the shell.
**Connect Base** -- disabled cells keep the base plate connected instead of being fully removed.
**Retain outer wall** -- keeps the outer bin wall around the full perimeter when connect base is on.
also: trailing whitespace at end of this line.
| Use "Save as defaults" to capture the current bin config. Use "Reset defaults" to restore factory settings (2x2 grid, 4u height, magnets on, stacking lip on). | ||
|
|
||
| ## Partial Bins | ||
|
|
There was a problem hiding this comment.
typo: "partia" should be "partial".
| Disabled cells keep base geometry but lose walls and lip above `BASE_HEIGHT`: | ||
|
|
||
| 1. **Wall cutters** (`_make_connect_mode_cell_cutters`) subtract everything from `BASE_HEIGHT` up to the bin top in each disabled cell. | ||
| 2. **Stability plates** (`_make_connect_mode_stability_plates`) add a ~5.8mm floor bridge (`PARTIAL_BIN_CONNECT_PLATE_MM = 6.0 - 0.2`) at `z = BASE_HEIGHT` across each disabled region. Plates extend half a grid unit into neighbouring enabled cells for adhesion. |
There was a problem hiding this comment.
minor: the constant is exactly 5.8mm (6.0 - 0.2), so the tilde (~) isn't needed.
| | Contrast Insert | Generates a separate insert STL for two-colour printing. | | ||
| | Insert Height | Thickness of the insert piece. | | ||
| | Bed Size | Print bed dimension. Bins exceeding this are split automatically. | | ||
| | Partial Bins | Disable specific parts of the bin to save filament. | |
There was a problem hiding this comment.
suggestion: the other rows in this table use factual descriptions without rationale. could trim "to save filament" to match, e.g.:
| Partial Bins | Disable individual grid cells in the bin. |
|
@jasonmadigan done. |
|
thanks @gr3enk! |
2 participants
Adding Markdown documentation for the partial bins feature addded in #112