adding comments to linear algebra operations
updating doc