better documentation + example files