BOSL2 icon indicating copy to clipboard operation
BOSL2 copied to clipboard

[BUG] possible documentation oversight

Open jon-bondy opened this issue 3 months ago • 2 comments

Describe the bug Some parts of the documentation are animated and some are not, inconsistently. It is not clear whether this is an oversight or by design

Code To Reproduce Bug

Go here
https://github.com/BelfrySCAD/BOSL2/wiki/partitions.scad#functionmodule-half_of
and compare "left_half()" and "right_half()".  One has animated images and one does not.  It is not clear to me whether this was intentional or not.

Expected behavior Perhaps all of the images should be animated

Screenshots N/A

Additional context

  • OpenSCAD Version: N/A
  • Other libraries used:

jon-bondy avatar Nov 23 '25 20:11 jon-bondy

Every example image is it's own little thing with its own independent properties. I'm guessing that Revar made some of them animated because he thought key information was invisible in a still image and the animation was required for clarity. Animations are lower resolution and use more storage and resources so we try to use them only when necessary for clarity. Do you think the images should all be animated in this case? (And what does "all" mean here?)

Note: don't put regular text in a code block here on github. It makes it hard to read.

adrianVmariano avatar Nov 23 '25 23:11 adrianVmariano

Do we have an action here or should I close this?

adrianVmariano avatar Dec 02 '25 15:12 adrianVmariano