{"action":"created","comment":{"url":"https://api.github.com/repos/pulp/pulpproject.org/pulls/comments/103304892","pull_request_review_id":24087441,"id":103304892,"diff_hunk":"@@ -0,0 +1,317 @@\n+---\n+title: PUP Purpose and Guidelines\n+author: Brian Bouterse\n+---\n+\n+Summary\n+=======\n+\n+This proposal provides a structured process to propose, track, discuss, and decide on process\n+changes for the Pulp project and community.\n+\n+Motivation\n+==========\n+\n+As initially [raised on the pulp-dev list](https://www.redhat.com/archives/pulp-dev/2017-February/msg00014.html),\n+Pulp lacks a process to propose, track, discuss, and decide on changes that affect the Pulp\n+community.\n+\n+This is a problem that has been addressed by many communities. The process outlined in this document\n+is inspired by processes in the Python, Django, and Foreman communities.\n+\n+\n+What are these called?\n+======================\n+\n+We need an acronym or initialization for these. Here are some quick ideas:\n+\n+* \"Pulp Update Proposal\" (PUP)\n+* \"Pulp Change Proposal\" (PCP)\n+* <Your idea here>\n+\n+\n+Tracking Proposals\n+==================\n+\n+Proposals would be in restructured text format and sent as a pull request against the\n+pulpproject.org repo or a dedicated repo. We could easily create a tab at the top of pulpproject.org\n+to show off merged proposals. This could also be in a separate, dedicated repo like Python does, but\n+for simplicity I'm modeling this using the pulpproject.org repo. The idea to render proposals is\n+similar to how [Python Enhancement Proposals (PEPs)](https://www.python.org/dev/peps/pep-0001/)\n+work, which are markdown documents that are also viewable/readable as rendered documents via a\n+browser.\n+\n+\n+Finding/Discovering Proposals\n+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+\n+An index mimicking [the Python one](https://www.python.org/dev/peps/) would be created which would\n+show all proposals in different states (active, approved, rejected, abandoned). These would also be\n+viewable via pulpproject.org in a dedicated area.\n+\n+\n+Proposal Process\n+================\n+\n+The overall process is: Pre-proposal -> Authoring -> Announcement ->  Discussion and Feedback ->\n+Revision -> Voting -> Decision\n+\n+Most of the process is facilitated using either the pulp-list or pulp-dev mailing lists. The\n+following guidelines identify how they should.\n+\n+* For changes impacting users, [pulp-list](https://www.redhat.com/mailman/listinfo/pulp-list) is the\n+  appropriate place.\n+* For changes impacting developers, [pulp-dev](https://www.redhat.com/mailman/listinfo/pulp-dev) is\n+  the appropriate place.\n+\n+Pre-Proposal\n+^^^^^^^^^^^^\n+\n+Discussing an idea via the appropriate mailing list prior to writing a formal proposal is\n+encouraged. This is intended to save the author time by gathering feedback quickly before writing a\n+concrete, detailed proposal.\n+\n+\n+Authoring\n+^^^^^^^^^\n+\n+One or more authors create the proposal as a pull request against\n+[the pulpproject.org repo](http://github.com/pulp/pulpproject.org/) using the next sequential\n+proposal number. The proposal is a single file, e.g. `pup-0022.rst`. A core dev is expected to\n+merge any proposal with adequate clarity and in the expected format.\n+\n+\n+Announcement\n+^^^^^^^^^^^^\n+\n+Once a proposal is merged to the proposals area, an announcement would be sent to the appropriate\n+list, which would include a very brief introduction and a link to the proposal in its web viewable\n+form.\n+\n+\n+Discussion and Feedback\n+^^^^^^^^^^^^^^^^^^^^^^^\n+\n+General discussion would occur on the announcement thread on the appropriate mailing list. Threaded\n+e-mail readers should make this conversation format easy to follow, while keeping the proposal\n+document in-tact and easy to read.\n+\n+\n+Revision\n+^^^^^^^^\n+\n+Revision would occur as additional pull requests against the active proposal. This allows the\n+changelog of a proposal to always be maintained. This is how Python does it. This also allows\n+edits/updates to come with a commit message indicating the concerns addressed or improvements\n+including links to responses via the archive. Collaboration is also easy with a collaborator sending\n+revisions to the author as a patch or a new pull request against the proposal.\n+\n+\n+Voting\n+^^^^^^\n+\n+The +1, +0, -0, -1 feedback process is used, with votes sent as responses via the\n+announcement/discussion mailing list. The voting has the following meanings:\n+\n+* +1: \"I love the idea and I’m strongly committed to it.\"","path":"_proposals/pup-0001.rst","position":116,"original_position":116,"commit_id":"425bb103687db9103b37fa530c27ada7b8c53ddf","original_commit_id":"425bb103687db9103b37fa530c27ada7b8c53ddf","user":{"login":"bmbouter","id":180319,"avatar_url":"https://avatars.githubusercontent.com/u/180319?v=3","gravatar_id":"","url":"https://api.github.com/users/bmbouter","html_url":"https://github.com/bmbouter","followers_url":"https://api.github.com/users/bmbouter/followers","following_url":"https://api.github.com/users/bmbouter/following{/other_user}","gists_url":"https://api.github.com/users/bmbouter/gists{/gist_id}","starred_url":"https://api.github.com/users/bmbouter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bmbouter/subscriptions","organizations_url":"https://api.github.com/users/bmbouter/orgs","repos_url":"https://api.github.com/users/bmbouter/repos","events_url":"https://api.github.com/users/bmbouter/events{/privacy}","received_events_url":"https://api.github.com/users/bmbouter/received_events","type":"User","site_admin":false},"body":"Updated in next push. I also removed the sentence reading `Also, -1 feedback should not be used to express subjective preferences.` since this wording makes that true for all vote types.","created_at":"2017-02-27T20:33:03Z","updated_at":"2017-02-27T20:33:03Z","html_url":"https://github.com/pulp/pulpproject.org/pull/50#discussion_r103304892","pull_request_url":"https://api.github.com/repos/pulp/pulpproject.org/pulls/50","_links":{"self":{"href":"https://api.github.com/repos/pulp/pulpproject.org/pulls/comments/103304892"},"html":{"href":"https://github.com/pulp/pulpproject.org/pull/50#discussion_r103304892"},"pull_request":{"href":"https://api.github.com/repos/pulp/pulpproject.org/pulls/50"}}},"pull_request":{"url":"https://api.github.com/repos/pulp/pulpproject.org/pulls/50","id":105963784,"html_url":"https://github.com/pulp/pulpproject.org/pull/50","diff_url":"https://github.com/pulp/pulpproject.org/pull/50.diff","patch_url":"https://github.com/pulp/pulpproject.org/pull/50.patch","issue_url":"https://api.github.com/repos/pulp/pulpproject.org/issues/50","number":50,"state":"open","locked":false,"title":"Meta proposal","user":{"login":"bmbouter","id":180319,"avatar_url":"https://avatars.githubusercontent.com/u/180319?v=3","gravatar_id":"","url":"https://api.github.com/users/bmbouter","html_url":"https://github.com/bmbouter","followers_url":"https://api.github.com/users/bmbouter/followers","following_url":"https://api.github.com/users/bmbouter/following{/other_user}","gists_url":"https://api.github.com/users/bmbouter/gists{/gist_id}","starred_url":"https://api.github.com/users/bmbouter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bmbouter/subscriptions","organizations_url":"https://api.github.com/users/bmbouter/orgs","repos_url":"https://api.github.com/users/bmbouter/repos","events_url":"https://api.github.com/users/bmbouter/events{/privacy}","received_events_url":"https://api.github.com/users/bmbouter/received_events","type":"User","site_admin":false},"body":"","created_at":"2017-02-13T19:37:42Z","updated_at":"2017-02-27T20:33:03Z","closed_at":null,"merged_at":null,"merge_commit_sha":"ad79a6ae97dd31c5a53da722449cf08ea80c08ba","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/pulp/pulpproject.org/pulls/50/commits","review_comments_url":"https://api.github.com/repos/pulp/pulpproject.org/pulls/50/comments","review_comment_url":"https://api.github.com/repos/pulp/pulpproject.org/pulls/comments{/number}","comments_url":"https://api.github.com/repos/pulp/pulpproject.org/issues/50/comments","statuses_url":"https://api.github.com/repos/pulp/pulpproject.org/statuses/425bb103687db9103b37fa530c27ada7b8c53ddf","head":{"label":"bmbouter:meta-proposal","ref":"meta-proposal","sha":"425bb103687db9103b37fa530c27ada7b8c53ddf","user":{"login":"bmbouter","id":180319,"avatar_url":"https://avatars.githubusercontent.com/u/180319?v=3","gravatar_id":"","url":"https://api.github.com/users/bmbouter","html_url":"https://github.com/bmbouter","followers_url":"https://api.github.com/users/bmbouter/followers","following_url":"https://api.github.com/users/bmbouter/following{/other_user}","gists_url":"https://api.github.com/users/bmbouter/gists{/gist_id}","starred_url":"https://api.github.com/users/bmbouter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bmbouter/subscriptions","organizations_url":"https://api.github.com/users/bmbouter/orgs","repos_url":"https://api.github.com/users/bmbouter/repos","events_url":"https://api.github.com/users/bmbouter/events{/privacy}","received_events_url":"https://api.github.com/users/bmbouter/received_events","type":"User","site_admin":false},"repo":{"id":59233880,"name":"pulpproject.org","full_name":"bmbouter/pulpproject.org","owner":{"login":"bmbouter","id":180319,"avatar_url":"https://avatars.githubusercontent.com/u/180319?v=3","gravatar_id":"","url":"https://api.github.com/users/bmbouter","html_url":"https://github.com/bmbouter","followers_url":"https://api.github.com/users/bmbouter/followers","following_url":"https://api.github.com/users/bmbouter/following{/other_user}","gists_url":"https://api.github.com/users/bmbouter/gists{/gist_id}","starred_url":"https://api.github.com/users/bmbouter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bmbouter/subscriptions","organizations_url":"https://api.github.com/users/bmbouter/orgs","repos_url":"https://api.github.com/users/bmbouter/repos","events_url":"https://api.github.com/users/bmbouter/events{/privacy}","received_events_url":"https://api.github.com/users/bmbouter/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/bmbouter/pulpproject.org","description":null,"fork":true,"url":"https://api.github.com/repos/bmbouter/pulpproject.org","forks_url":"https://api.github.com/repos/bmbouter/pulpproject.org/forks","keys_url":"https://api.github.com/repos/bmbouter/pulpproject.org/keys{/key_id}","collaborators_url":"https://api.github.com/repos/bmbouter/pulpproject.org/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/bmbouter/pulpproject.org/teams","hooks_url":"https://api.github.com/repos/bmbouter/pulpproject.org/hooks","issue_events_url":"https://api.github.com/repos/bmbouter/pulpproject.org/issues/events{/number}","events_url":"https://api.github.com/repos/bmbouter/pulpproject.org/events","assignees_url":"https://api.github.com/repos/bmbouter/pulpproject.org/assignees{/user}","branches_url":"https://api.github.com/repos/bmbouter/pulpproject.org/branches{/branch}","tags_url":"https://api.github.com/repos/bmbouter/pulpproject.org/tags","blobs_url":"https://api.github.com/repos/bmbouter/pulpproject.org/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/bmbouter/pulpproject.org/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/bmbouter/pulpproject.org/git/refs{/sha}","trees_url":"https://api.github.com/repos/bmbouter/pulpproject.org/git/trees{/sha}","statuses_url":"https://api.github.com/repos/bmbouter/pulpproject.org/statuses/{sha}","languages_url":"https://api.github.com/repos/bmbouter/pulpproject.org/languages","stargazers_url":"https://api.github.com/repos/bmbouter/pulpproject.org/stargazers","contributors_url":"https://api.github.com/repos/bmbouter/pulpproject.org/contributors","subscribers_url":"https://api.github.com/repos/bmbouter/pulpproject.org/subscribers","subscription_url":"https://api.github.com/repos/bmbouter/pulpproject.org/subscription","commits_url":"https://api.github.com/repos/bmbouter/pulpproject.org/commits{/sha}","git_commits_url":"https://api.github.com/repos/bmbouter/pulpproject.org/git/commits{/sha}","comments_url":"https://api.github.com/repos/bmbouter/pulpproject.org/comments{/number}","issue_comment_url":"https://api.github.com/repos/bmbouter/pulpproject.org/issues/comments{/number}","contents_url":"https://api.github.com/repos/bmbouter/pulpproject.org/contents/{+path}","compare_url":"https://api.github.com/repos/bmbouter/pulpproject.org/compare/{base}...{head}","merges_url":"https://api.github.com/repos/bmbouter/pulpproject.org/merges","archive_url":"https://api.github.com/repos/bmbouter/pulpproject.org/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/bmbouter/pulpproject.org/downloads","issues_url":"https://api.github.com/repos/bmbouter/pulpproject.org/issues{/number}","pulls_url":"https://api.github.com/repos/bmbouter/pulpproject.org/pulls{/number}","milestones_url":"https://api.github.com/repos/bmbouter/pulpproject.org/milestones{/number}","notifications_url":"https://api.github.com/repos/bmbouter/pulpproject.org/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/bmbouter/pulpproject.org/labels{/name}","releases_url":"https://api.github.com/repos/bmbouter/pulpproject.org/releases{/id}","deployments_url":"https://api.github.com/repos/bmbouter/pulpproject.org/deployments","created_at":"2016-05-19T19:00:31Z","updated_at":"2016-06-30T18:20:12Z","pushed_at":"2017-02-24T23:47:33Z","git_url":"git://github.com/bmbouter/pulpproject.org.git","ssh_url":"git@github.com:bmbouter/pulpproject.org.git","clone_url":"https://github.com/bmbouter/pulpproject.org.git","svn_url":"https://github.com/bmbouter/pulpproject.org","homepage":null,"size":12705,"stargazers_count":0,"watchers_count":0,"language":"CSS","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":1,"mirror_url":null,"open_issues_count":0,"forks":1,"open_issues":0,"watchers":0,"default_branch":"gh-pages"}},"base":{"label":"pulp:gh-pages","ref":"gh-pages","sha":"349b24ce7907e0a2ee25c206590cee0c3f181076","user":{"login":"pulp","id":2103606,"avatar_url":"https://avatars.githubusercontent.com/u/2103606?v=3","gravatar_id":"","url":"https://api.github.com/users/pulp","html_url":"https://github.com/pulp","followers_url":"https://api.github.com/users/pulp/followers","following_url":"https://api.github.com/users/pulp/following{/other_user}","gists_url":"https://api.github.com/users/pulp/gists{/gist_id}","starred_url":"https://api.github.com/users/pulp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pulp/subscriptions","organizations_url":"https://api.github.com/users/pulp/orgs","repos_url":"https://api.github.com/users/pulp/repos","events_url":"https://api.github.com/users/pulp/events{/privacy}","received_events_url":"https://api.github.com/users/pulp/received_events","type":"Organization","site_admin":false},"repo":{"id":59233761,"name":"pulpproject.org","full_name":"pulp/pulpproject.org","owner":{"login":"pulp","id":2103606,"avatar_url":"https://avatars.githubusercontent.com/u/2103606?v=3","gravatar_id":"","url":"https://api.github.com/users/pulp","html_url":"https://github.com/pulp","followers_url":"https://api.github.com/users/pulp/followers","following_url":"https://api.github.com/users/pulp/following{/other_user}","gists_url":"https://api.github.com/users/pulp/gists{/gist_id}","starred_url":"https://api.github.com/users/pulp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pulp/subscriptions","organizations_url":"https://api.github.com/users/pulp/orgs","repos_url":"https://api.github.com/users/pulp/repos","events_url":"https://api.github.com/users/pulp/events{/privacy}","received_events_url":"https://api.github.com/users/pulp/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/pulp/pulpproject.org","description":null,"fork":false,"url":"https://api.github.com/repos/pulp/pulpproject.org","forks_url":"https://api.github.com/repos/pulp/pulpproject.org/forks","keys_url":"https://api.github.com/repos/pulp/pulpproject.org/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pulp/pulpproject.org/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pulp/pulpproject.org/teams","hooks_url":"https://api.github.com/repos/pulp/pulpproject.org/hooks","issue_events_url":"https://api.github.com/repos/pulp/pulpproject.org/issues/events{/number}","events_url":"https://api.github.com/repos/pulp/pulpproject.org/events","assignees_url":"https://api.github.com/repos/pulp/pulpproject.org/assignees{/user}","branches_url":"https://api.github.com/repos/pulp/pulpproject.org/branches{/branch}","tags_url":"https://api.github.com/repos/pulp/pulpproject.org/tags","blobs_url":"https://api.github.com/repos/pulp/pulpproject.org/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pulp/pulpproject.org/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pulp/pulpproject.org/git/refs{/sha}","trees_url":"https://api.github.com/repos/pulp/pulpproject.org/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pulp/pulpproject.org/statuses/{sha}","languages_url":"https://api.github.com/repos/pulp/pulpproject.org/languages","stargazers_url":"https://api.github.com/repos/pulp/pulpproject.org/stargazers","contributors_url":"https://api.github.com/repos/pulp/pulpproject.org/contributors","subscribers_url":"https://api.github.com/repos/pulp/pulpproject.org/subscribers","subscription_url":"https://api.github.com/repos/pulp/pulpproject.org/subscription","commits_url":"https://api.github.com/repos/pulp/pulpproject.org/commits{/sha}","git_commits_url":"https://api.github.com/repos/pulp/pulpproject.org/git/commits{/sha}","comments_url":"https://api.github.com/repos/pulp/pulpproject.org/comments{/number}","issue_comment_url":"https://api.github.com/repos/pulp/pulpproject.org/issues/comments{/number}","contents_url":"https://api.github.com/repos/pulp/pulpproject.org/contents/{+path}","compare_url":"https://api.github.com/repos/pulp/pulpproject.org/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pulp/pulpproject.org/merges","archive_url":"https://api.github.com/repos/pulp/pulpproject.org/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pulp/pulpproject.org/downloads","issues_url":"https://api.github.com/repos/pulp/pulpproject.org/issues{/number}","pulls_url":"https://api.github.com/repos/pulp/pulpproject.org/pulls{/number}","milestones_url":"https://api.github.com/repos/pulp/pulpproject.org/milestones{/number}","notifications_url":"https://api.github.com/repos/pulp/pulpproject.org/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pulp/pulpproject.org/labels{/name}","releases_url":"https://api.github.com/repos/pulp/pulpproject.org/releases{/id}","deployments_url":"https://api.github.com/repos/pulp/pulpproject.org/deployments","created_at":"2016-05-19T18:58:43Z","updated_at":"2016-07-19T20:09:26Z","pushed_at":"2017-02-24T23:47:34Z","git_url":"git://github.com/pulp/pulpproject.org.git","ssh_url":"git@github.com:pulp/pulpproject.org.git","clone_url":"https://github.com/pulp/pulpproject.org.git","svn_url":"https://github.com/pulp/pulpproject.org","homepage":null,"size":12702,"stargazers_count":0,"watchers_count":0,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":11,"mirror_url":null,"open_issues_count":7,"forks":11,"open_issues":7,"watchers":0,"default_branch":"gh-pages"}},"_links":{"self":{"href":"https://api.github.com/repos/pulp/pulpproject.org/pulls/50"},"html":{"href":"https://github.com/pulp/pulpproject.org/pull/50"},"issue":{"href":"https://api.github.com/repos/pulp/pulpproject.org/issues/50"},"comments":{"href":"https://api.github.com/repos/pulp/pulpproject.org/issues/50/comments"},"review_comments":{"href":"https://api.github.com/repos/pulp/pulpproject.org/pulls/50/comments"},"review_comment":{"href":"https://api.github.com/repos/pulp/pulpproject.org/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/pulp/pulpproject.org/pulls/50/commits"},"statuses":{"href":"https://api.github.com/repos/pulp/pulpproject.org/statuses/425bb103687db9103b37fa530c27ada7b8c53ddf"}}}}
{"actor":{"display_login":"bmbouter"}}