You could make jobs that represent complete subjects and multiple jobs to connect them, also metadata on the jobs/transformations and steps (like descriptions) are very helpful.
In the past we got "kettle-cookbook" that read metadata and output html... the "documentation step" is not as good as cookbook was!