add hook-up instructions and improve code readability and output