some more docs cleanup and added a section about building shopping lists