two new section in docs to keep in mind