starting to document package tweaks