I agree, the docs need improvement. Last time I checked fixatoms docstring was speaking of the input for a lattice cell!
Feel free to clarify the points that are unclear, and commit the changes as a pull request on github. It's only by having people
like you involved, who look into the details, that the documentation effort can move forward!
Thanks