started documenting
fix warnings