add documentation to brick helper method
fix merge conflict