Rewrite pin module documentation to clarify usage and invariants
#116129
+1,104
−375
pin module documentation to clarify usage and invariants
#116129