Add `publish` property to CI yaml doc

Add the new publish property of the pages Job to the CI Yaml documentation: https://docs.gitlab.com/ee/ci/yaml/.

Follow up from !116789 (merged)