doc: add doc to find_files_to_publish
doc: clarify publish_item docs
refactor: vastly simplify publish functions