update basics docs