nullbitsco / docs

Online documentation (build guides, user manuals, etc) for nullbits products.
63 stars 39 forks source link

Add 3D CAD view to all guides #17

Closed jaygreco closed 2 years ago

jaygreco commented 3 years ago

See below for more feedback:

"The grammar should be changed and made more precise. Instead of writing "...screw the M2x3 standoffs into the TOP PCB plate", write "...screw the M2x3 standoffs into the bottom side of the top PCB plate".

In addition, circling the diagram with red circles is ambiguous. It is unclear if the circles are used to denote the standoff or the screw. A caption on the diagram with "Place the standoffs on the red circles" would have clarified this.

There are various points in the guide where additional pictures are useful. Often, the pictures that are included are ambiguous or not helpful for that particular step. Additional annotations on the figures would be helpful.

The ordering of the material in the guide is confusing, at times, partly because the guide was not meant to orient towards e.g. plate installs vs. socket install vs other things. In many cases, a CAD-like diagram would have simplified life enormously as well, rather than digitised pictures.

Even a hand-drawn image of the side view, showing the general layering (bottom plate, acrylic plate, screw, , standoff, midplate, top plate, etc.) is often more helpful than a page of text. "

jaygreco commented 2 years ago

SNAP1 SIDE2 SIDE1 TIDBIT1 NIBBLE1