lib docs 1-3