Add section about return values to documentation