mark legacy services in doc
add a env var config section for services' README
add doc briefly explaining hexagonal architecture