{"action":"closed","issue":{"url":"https://api.github.com/repos/openshift/openshift-docs/issues/1227","labels_url":"https://api.github.com/repos/openshift/openshift-docs/issues/1227/labels{/name}","comments_url":"https://api.github.com/repos/openshift/openshift-docs/issues/1227/comments","events_url":"https://api.github.com/repos/openshift/openshift-docs/issues/1227/events","html_url":"https://github.com/openshift/openshift-docs/issues/1227","id":117714621,"number":1227,"title":"Better docs for jobs","user":{"login":"kargakis","id":3900799,"avatar_url":"https://avatars.githubusercontent.com/u/3900799?v=3","gravatar_id":"","url":"https://api.github.com/users/kargakis","html_url":"https://github.com/kargakis","followers_url":"https://api.github.com/users/kargakis/followers","following_url":"https://api.github.com/users/kargakis/following{/other_user}","gists_url":"https://api.github.com/users/kargakis/gists{/gist_id}","starred_url":"https://api.github.com/users/kargakis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kargakis/subscriptions","organizations_url":"https://api.github.com/users/kargakis/orgs","repos_url":"https://api.github.com/users/kargakis/repos","events_url":"https://api.github.com/users/kargakis/events{/privacy}","received_events_url":"https://api.github.com/users/kargakis/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2015-11-19T00:38:45Z","updated_at":"2015-11-26T01:18:10Z","closed_at":"2015-11-26T01:18:10Z","body":"1) https://docs.openshift.org/latest/dev_guide/jobs.html doesn't let me know what jobs are about and why would I want to use them (would be better to compare against a deployment (dc) rather than a replication controller?). \r\n\r\n2) I think the explanation about parallelism is slightly wrong. It mentions about running pods concurrently but I think we should be more specific and note that parallelism means the maximum # of pods that can run in **parallel** at a given time. Also we should probably document the [logic](https://github.com/kubernetes/kubernetes/blob/742243bb4adc9dc83411354566667259bcd7d7ee/pkg/controller/job/controller.go#L364) in the job controller. As a user I think I would be interested in these details.\r\n\r\n3) The scaling part should make it explicit that by scaling a job we scale the pods that can run in parallel and maybe reduce the amount of times parallelism is mentioned (one would probably be enough?)\r\n\r\ncc: @soltysh \r\n\r\n@tnguyen-rh interested in getting into jobs? :P"}}