adding documentation to the howtos