add documentation for "equal" helper