update docs
use permalinks lib