PTFM-2681: taking into account code review comments and re-documenting the build process