[py]: consolidate and document linting changes; enable linting in gh actions