code doc + README update