{"action":"created","comment":{"url":"https://api.github.com/repos/in-toto/ITE/pulls/comments/223662213","pull_request_review_id":162840852,"id":223662213,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDIyMzY2MjIxMw==","diff_hunk":"@@ -0,0 +1,925 @@\n+= ITE-1: in-toto Enhancement Format\n+:source-highlighter: pygments\n+:toc: preamble\n+:toclevels: 2\n+ifdef::env-github[]\n+:tip-caption: :bulb:\n+:note-caption: :information_source:\n+:important-caption: :heavy_exclamation_mark:\n+:caution-caption: :fire:\n+:warning-caption: :warning:\n+endif::[]\n+\n+.Metadata\n+[cols=\"2\"]\n+|===\n+| ITE\n+| 1\n+\n+| Title\n+| in-toto Enhancement format\n+\n+| Sponsor\n+| link:https://github.com/santiagotorres[Santiago Torres-Arias]\n+\n+| Status\n+| Active :smile:\n+\n+| Type\n+| Process\n+\n+| Created\n+| 2018-10-04\n+\n+|===\n+\n+\n+[[abstract]]\n+== Abstract\n+\n+An in-toto Enhancement (ITE) is a design document that describes a new feature\n+or aspect of the in-toto framework, a setup of its supply chain or an,\n+organizational aspect of the in-toto project.  This ITE describes the structure\n+of ITE documents and details the process by which ITEs are created, submitted,\n+reviewed, finalized, and maintained.\n+\n+[[specification]]\n+== Specification\n+\n+=== What is an ITE?\n+\n+ITE stands for in-toto Enhancement. An ITE is a design document that describes\n+a new feature or aspect of the in-toto framework, the in-toto supply chain, or\n+the process within in-toto project. An ITE provides a concise technical\n+specification of the feature, describes the motivation for the change, and\n+discusses the rationale behind the design.\n+\n+ITEs are the primary mechanism for proposing major new features, for collecting\n+community input on an issue, and for documenting the design decisions that have\n+gone into in-toto. Each ITE must have at least one <<Sponsor>>. The ITE Sponsor\n+is responsible for the ITE overall - building consensus for that ITE within the\n+community, documenting dissenting opinions, coordinating contributors work, and\n+generally ensuring the ITE meets the style, format, and quality guidelines\n+described below. An ITE may also have any number of <<Contributor,\n+Contributors>> who help write, implement, discuss, or offer feedback about\n+the ITE. One contributor might do only one or any combination of these things\n+during any part of the life of a ITE.\n+\n+Because the ITEs are maintained as text files in a versioned\n+repository, their revision history is the historical record of the\n+feature proposal footnoteref:[repo, https://github.com/in-toto/ITE].\n+\n+[NOTE]\n+====\n+For non-text files added to the repository, such as images, the files must be\n+readable with free or open source tools, and should ideally be editable by\n+other contributors. For example, use SVG rather than PSD for vector graphics.\n+====\n+\n+=== ITE Types\n+\n+There are three kinds of ITE:\n+\n+. A **Standards Track** ITE describes a new feature or implementation\n+ for the in-toto specification. It may also describe an interoperability or\n+ backwards-compatibility standard which will be supported for the feature in\n+ current versions of in-toto, moving forward.\n+. An **Informational** ITE describes an in-totodesign issue, or\n+ provides general guidelines or information to the in-toto community,\n+ but does not propose a new feature. Informational ITEs do not\n+ necessarily represent a in-toto community consensus or\n+ recommendation, so users and implementers are free to ignore\n+ Informational ITEs or follow their advice. An example of an informational ITE \n+ would be the recommendations for integrating in-toto and TUF.\n+. A **Process** ITE describes a process surrounding the in-toto project, or\n+ proposes a change to (or an event in) a process. Process ITEs are like\n+ Standards Track ITEs but apply to areas other than the in-toto specification\n+ itself. They may propose an implementation, but not for what would be\n+ generally considered the in-toto codebase; they often require community\n+ consensus; unlike Informational ITEs, they are more than recommendations, and\n+ users are typically not free to ignore them. Examples include procedures,\n+ guidelines, changes to the decision-making process, and changes to the tools\n+ or environment used in in-toto development. Any meta-ITE (ITE focusing on the\n+ improvement of the in-toto Enhancement process) is also considered a\n+ Process ITE.\n+\n+=== ITE Terminology\n+\n+==== Editor\n+\n+The ITE editors are individuals responsible for managing the administrative\n+and editorial aspects of the ITE workflow (e.g. assigning ITE numbers and\n+changing their status). See <<editor-responsibilities, ITE Editor Responsibilities & Workflow>> for\n+details. \n+\n+ITE editorship is by invitation of the current editors. All of the ITE workflow\n+can be conducted via the GitHub ITE Repository footnoteref:[repo] and pull\n+requests. Editors are members of a GitHub group called `ITE-editors`.\n+\n+==== Contributor\n+\n+A ITE may have any number of `Contributors` who help write, implement, discuss,\n+or offer feedback about that ITE. One contributor might do only one or any\n+combination of these of these things during any part of the life of a ITE.\n+While we invite contributions by companies or other organizations, contributors\n+listed in a ITE need to be specific people.\n+\n+==== Sponsor\n+\n+Each ITE has at least one \"Sponsor\".\n+\n+The ITE Sponsor is a contributor who is responsible for the ITE throughout its\n+lifecycle. Their responsibilities include:\n+\n+* Building consensus for that ITE within the community\n+* Documenting dissenting opinions\n+* Coordinating contributors' work\n+* Ensuring the ITE meets the style, format, and quality guidelines\n+* Maintaining the ITE after it is finalized\n+* Setting and communicating the schedule as needed\n+\n+The Sponsor of a ITE may or may not do any of the tasks other contributors do.\n+For example, one sponsor might write large portions of one ITE, while another\n+sponsor might leave the writing to other contributors.\n+\n+Anyone may be Sponsor for a ITE, though it should be someone familiar enough","path":"ITE/1/README.adoc","position":145,"original_position":145,"commit_id":"bdf64cb86b7e28d737bb372d972cd9f040cd996b","original_commit_id":"bdf64cb86b7e28d737bb372d972cd9f040cd996b","user":{"login":"reza-curtmola","id":14241779,"node_id":"MDQ6VXNlcjE0MjQxNzc5","avatar_url":"https://avatars1.githubusercontent.com/u/14241779?v=4","gravatar_id":"","url":"https://api.github.com/users/reza-curtmola","html_url":"https://github.com/reza-curtmola","followers_url":"https://api.github.com/users/reza-curtmola/followers","following_url":"https://api.github.com/users/reza-curtmola/following{/other_user}","gists_url":"https://api.github.com/users/reza-curtmola/gists{/gist_id}","starred_url":"https://api.github.com/users/reza-curtmola/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/reza-curtmola/subscriptions","organizations_url":"https://api.github.com/users/reza-curtmola/orgs","repos_url":"https://api.github.com/users/reza-curtmola/repos","events_url":"https://api.github.com/users/reza-curtmola/events{/privacy}","received_events_url":"https://api.github.com/users/reza-curtmola/received_events","type":"User","site_admin":false},"body":"Add \"a\" before Sponsor","created_at":"2018-10-09T11:33:06Z","updated_at":"2018-10-09T11:33:06Z","html_url":"https://github.com/in-toto/ITE/pull/1#discussion_r223662213","pull_request_url":"https://api.github.com/repos/in-toto/ITE/pulls/1","author_association":"NONE","_links":{"self":{"href":"https://api.github.com/repos/in-toto/ITE/pulls/comments/223662213"},"html":{"href":"https://github.com/in-toto/ITE/pull/1#discussion_r223662213"},"pull_request":{"href":"https://api.github.com/repos/in-toto/ITE/pulls/1"}}},"pull_request":{"url":"https://api.github.com/repos/in-toto/ITE/pulls/1","id":220553985,"node_id":"MDExOlB1bGxSZXF1ZXN0MjIwNTUzOTg1","html_url":"https://github.com/in-toto/ITE/pull/1","diff_url":"https://github.com/in-toto/ITE/pull/1.diff","patch_url":"https://github.com/in-toto/ITE/pull/1.patch","issue_url":"https://api.github.com/repos/in-toto/ITE/issues/1","number":1,"state":"open","locked":false,"title":"ENH: 01: add initial draft","user":{"login":"SantiagoTorres","id":3579933,"node_id":"MDQ6VXNlcjM1Nzk5MzM=","avatar_url":"https://avatars1.githubusercontent.com/u/3579933?v=4","gravatar_id":"","url":"https://api.github.com/users/SantiagoTorres","html_url":"https://github.com/SantiagoTorres","followers_url":"https://api.github.com/users/SantiagoTorres/followers","following_url":"https://api.github.com/users/SantiagoTorres/following{/other_user}","gists_url":"https://api.github.com/users/SantiagoTorres/gists{/gist_id}","starred_url":"https://api.github.com/users/SantiagoTorres/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SantiagoTorres/subscriptions","organizations_url":"https://api.github.com/users/SantiagoTorres/orgs","repos_url":"https://api.github.com/users/SantiagoTorres/repos","events_url":"https://api.github.com/users/SantiagoTorres/events{/privacy}","received_events_url":"https://api.github.com/users/SantiagoTorres/received_events","type":"User","site_admin":false},"body":"@in-toto/ite-editors \r\n\r\nHere's the draft of the first ITE (In-toto Enhancement). It's heavily based off of the JEP format. Please everyone comment on it!\r\n\r\n@lukpueh @reza-curtmola @trishankatdatadog @ofek ","created_at":"2018-10-05T00:26:54Z","updated_at":"2018-10-09T11:33:06Z","closed_at":null,"merged_at":null,"merge_commit_sha":"7b625043664f3b5ee7006faf4e2b1388caa966e3","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[{"id":1078229940,"node_id":"MDU6TGFiZWwxMDc4MjI5OTQw","url":"https://api.github.com/repos/in-toto/ITE/labels/enhancement","name":"enhancement","color":"a2eeef","default":true}],"milestone":null,"commits_url":"https://api.github.com/repos/in-toto/ITE/pulls/1/commits","review_comments_url":"https://api.github.com/repos/in-toto/ITE/pulls/1/comments","review_comment_url":"https://api.github.com/repos/in-toto/ITE/pulls/comments{/number}","comments_url":"https://api.github.com/repos/in-toto/ITE/issues/1/comments","statuses_url":"https://api.github.com/repos/in-toto/ITE/statuses/bdf64cb86b7e28d737bb372d972cd9f040cd996b","head":{"label":"SantiagoTorres:jep-xxxx","ref":"jep-xxxx","sha":"bdf64cb86b7e28d737bb372d972cd9f040cd996b","user":{"login":"SantiagoTorres","id":3579933,"node_id":"MDQ6VXNlcjM1Nzk5MzM=","avatar_url":"https://avatars1.githubusercontent.com/u/3579933?v=4","gravatar_id":"","url":"https://api.github.com/users/SantiagoTorres","html_url":"https://github.com/SantiagoTorres","followers_url":"https://api.github.com/users/SantiagoTorres/followers","following_url":"https://api.github.com/users/SantiagoTorres/following{/other_user}","gists_url":"https://api.github.com/users/SantiagoTorres/gists{/gist_id}","starred_url":"https://api.github.com/users/SantiagoTorres/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SantiagoTorres/subscriptions","organizations_url":"https://api.github.com/users/SantiagoTorres/orgs","repos_url":"https://api.github.com/users/SantiagoTorres/repos","events_url":"https://api.github.com/users/SantiagoTorres/events{/privacy}","received_events_url":"https://api.github.com/users/SantiagoTorres/received_events","type":"User","site_admin":false},"repo":{"id":151652127,"node_id":"MDEwOlJlcG9zaXRvcnkxNTE2NTIxMjc=","name":"ITE","full_name":"SantiagoTorres/ITE","private":false,"owner":{"login":"SantiagoTorres","id":3579933,"node_id":"MDQ6VXNlcjM1Nzk5MzM=","avatar_url":"https://avatars1.githubusercontent.com/u/3579933?v=4","gravatar_id":"","url":"https://api.github.com/users/SantiagoTorres","html_url":"https://github.com/SantiagoTorres","followers_url":"https://api.github.com/users/SantiagoTorres/followers","following_url":"https://api.github.com/users/SantiagoTorres/following{/other_user}","gists_url":"https://api.github.com/users/SantiagoTorres/gists{/gist_id}","starred_url":"https://api.github.com/users/SantiagoTorres/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SantiagoTorres/subscriptions","organizations_url":"https://api.github.com/users/SantiagoTorres/orgs","repos_url":"https://api.github.com/users/SantiagoTorres/repos","events_url":"https://api.github.com/users/SantiagoTorres/events{/privacy}","received_events_url":"https://api.github.com/users/SantiagoTorres/received_events","type":"User","site_admin":false},"html_url":"https://github.com/SantiagoTorres/ITE","description":null,"fork":true,"url":"https://api.github.com/repos/SantiagoTorres/ITE","forks_url":"https://api.github.com/repos/SantiagoTorres/ITE/forks","keys_url":"https://api.github.com/repos/SantiagoTorres/ITE/keys{/key_id}","collaborators_url":"https://api.github.com/repos/SantiagoTorres/ITE/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/SantiagoTorres/ITE/teams","hooks_url":"https://api.github.com/repos/SantiagoTorres/ITE/hooks","issue_events_url":"https://api.github.com/repos/SantiagoTorres/ITE/issues/events{/number}","events_url":"https://api.github.com/repos/SantiagoTorres/ITE/events","assignees_url":"https://api.github.com/repos/SantiagoTorres/ITE/assignees{/user}","branches_url":"https://api.github.com/repos/SantiagoTorres/ITE/branches{/branch}","tags_url":"https://api.github.com/repos/SantiagoTorres/ITE/tags","blobs_url":"https://api.github.com/repos/SantiagoTorres/ITE/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/SantiagoTorres/ITE/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/SantiagoTorres/ITE/git/refs{/sha}","trees_url":"https://api.github.com/repos/SantiagoTorres/ITE/git/trees{/sha}","statuses_url":"https://api.github.com/repos/SantiagoTorres/ITE/statuses/{sha}","languages_url":"https://api.github.com/repos/SantiagoTorres/ITE/languages","stargazers_url":"https://api.github.com/repos/SantiagoTorres/ITE/stargazers","contributors_url":"https://api.github.com/repos/SantiagoTorres/ITE/contributors","subscribers_url":"https://api.github.com/repos/SantiagoTorres/ITE/subscribers","subscription_url":"https://api.github.com/repos/SantiagoTorres/ITE/subscription","commits_url":"https://api.github.com/repos/SantiagoTorres/ITE/commits{/sha}","git_commits_url":"https://api.github.com/repos/SantiagoTorres/ITE/git/commits{/sha}","comments_url":"https://api.github.com/repos/SantiagoTorres/ITE/comments{/number}","issue_comment_url":"https://api.github.com/repos/SantiagoTorres/ITE/issues/comments{/number}","contents_url":"https://api.github.com/repos/SantiagoTorres/ITE/contents/{+path}","compare_url":"https://api.github.com/repos/SantiagoTorres/ITE/compare/{base}...{head}","merges_url":"https://api.github.com/repos/SantiagoTorres/ITE/merges","archive_url":"https://api.github.com/repos/SantiagoTorres/ITE/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/SantiagoTorres/ITE/downloads","issues_url":"https://api.github.com/repos/SantiagoTorres/ITE/issues{/number}","pulls_url":"https://api.github.com/repos/SantiagoTorres/ITE/pulls{/number}","milestones_url":"https://api.github.com/repos/SantiagoTorres/ITE/milestones{/number}","notifications_url":"https://api.github.com/repos/SantiagoTorres/ITE/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/SantiagoTorres/ITE/labels{/name}","releases_url":"https://api.github.com/repos/SantiagoTorres/ITE/releases{/id}","deployments_url":"https://api.github.com/repos/SantiagoTorres/ITE/deployments","created_at":"2018-10-05T00:23:23Z","updated_at":"2018-10-05T00:23:25Z","pushed_at":"2018-10-05T02:36:24Z","git_url":"git://github.com/SantiagoTorres/ITE.git","ssh_url":"git@github.com:SantiagoTorres/ITE.git","clone_url":"https://github.com/SantiagoTorres/ITE.git","svn_url":"https://github.com/SantiagoTorres/ITE","homepage":"","size":53,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":null,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"in-toto:master","ref":"master","sha":"4e6e505b3856cb3408bc3cd43015966b4f66b32b","user":{"login":"in-toto","id":22891761,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIyODkxNzYx","avatar_url":"https://avatars0.githubusercontent.com/u/22891761?v=4","gravatar_id":"","url":"https://api.github.com/users/in-toto","html_url":"https://github.com/in-toto","followers_url":"https://api.github.com/users/in-toto/followers","following_url":"https://api.github.com/users/in-toto/following{/other_user}","gists_url":"https://api.github.com/users/in-toto/gists{/gist_id}","starred_url":"https://api.github.com/users/in-toto/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/in-toto/subscriptions","organizations_url":"https://api.github.com/users/in-toto/orgs","repos_url":"https://api.github.com/users/in-toto/repos","events_url":"https://api.github.com/users/in-toto/events{/privacy}","received_events_url":"https://api.github.com/users/in-toto/received_events","type":"Organization","site_admin":false},"repo":{"id":151440964,"node_id":"MDEwOlJlcG9zaXRvcnkxNTE0NDA5NjQ=","name":"ITE","full_name":"in-toto/ITE","private":false,"owner":{"login":"in-toto","id":22891761,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIyODkxNzYx","avatar_url":"https://avatars0.githubusercontent.com/u/22891761?v=4","gravatar_id":"","url":"https://api.github.com/users/in-toto","html_url":"https://github.com/in-toto","followers_url":"https://api.github.com/users/in-toto/followers","following_url":"https://api.github.com/users/in-toto/following{/other_user}","gists_url":"https://api.github.com/users/in-toto/gists{/gist_id}","starred_url":"https://api.github.com/users/in-toto/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/in-toto/subscriptions","organizations_url":"https://api.github.com/users/in-toto/orgs","repos_url":"https://api.github.com/users/in-toto/repos","events_url":"https://api.github.com/users/in-toto/events{/privacy}","received_events_url":"https://api.github.com/users/in-toto/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/in-toto/ITE","description":"in-toto Enhancements","fork":false,"url":"https://api.github.com/repos/in-toto/ITE","forks_url":"https://api.github.com/repos/in-toto/ITE/forks","keys_url":"https://api.github.com/repos/in-toto/ITE/keys{/key_id}","collaborators_url":"https://api.github.com/repos/in-toto/ITE/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/in-toto/ITE/teams","hooks_url":"https://api.github.com/repos/in-toto/ITE/hooks","issue_events_url":"https://api.github.com/repos/in-toto/ITE/issues/events{/number}","events_url":"https://api.github.com/repos/in-toto/ITE/events","assignees_url":"https://api.github.com/repos/in-toto/ITE/assignees{/user}","branches_url":"https://api.github.com/repos/in-toto/ITE/branches{/branch}","tags_url":"https://api.github.com/repos/in-toto/ITE/tags","blobs_url":"https://api.github.com/repos/in-toto/ITE/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/in-toto/ITE/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/in-toto/ITE/git/refs{/sha}","trees_url":"https://api.github.com/repos/in-toto/ITE/git/trees{/sha}","statuses_url":"https://api.github.com/repos/in-toto/ITE/statuses/{sha}","languages_url":"https://api.github.com/repos/in-toto/ITE/languages","stargazers_url":"https://api.github.com/repos/in-toto/ITE/stargazers","contributors_url":"https://api.github.com/repos/in-toto/ITE/contributors","subscribers_url":"https://api.github.com/repos/in-toto/ITE/subscribers","subscription_url":"https://api.github.com/repos/in-toto/ITE/subscription","commits_url":"https://api.github.com/repos/in-toto/ITE/commits{/sha}","git_commits_url":"https://api.github.com/repos/in-toto/ITE/git/commits{/sha}","comments_url":"https://api.github.com/repos/in-toto/ITE/comments{/number}","issue_comment_url":"https://api.github.com/repos/in-toto/ITE/issues/comments{/number}","contents_url":"https://api.github.com/repos/in-toto/ITE/contents/{+path}","compare_url":"https://api.github.com/repos/in-toto/ITE/compare/{base}...{head}","merges_url":"https://api.github.com/repos/in-toto/ITE/merges","archive_url":"https://api.github.com/repos/in-toto/ITE/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/in-toto/ITE/downloads","issues_url":"https://api.github.com/repos/in-toto/ITE/issues{/number}","pulls_url":"https://api.github.com/repos/in-toto/ITE/pulls{/number}","milestones_url":"https://api.github.com/repos/in-toto/ITE/milestones{/number}","notifications_url":"https://api.github.com/repos/in-toto/ITE/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/in-toto/ITE/labels{/name}","releases_url":"https://api.github.com/repos/in-toto/ITE/releases{/id}","deployments_url":"https://api.github.com/repos/in-toto/ITE/deployments","created_at":"2018-10-03T16:04:43Z","updated_at":"2018-10-08T14:20:05Z","pushed_at":"2018-10-05T02:36:25Z","git_url":"git://github.com/in-toto/ITE.git","ssh_url":"git@github.com:in-toto/ITE.git","clone_url":"https://github.com/in-toto/ITE.git","svn_url":"https://github.com/in-toto/ITE","homepage":"","size":0,"stargazers_count":1,"watchers_count":1,"language":null,"has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":2,"mirror_url":null,"archived":false,"open_issues_count":1,"license":null,"forks":2,"open_issues":1,"watchers":1,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/in-toto/ITE/pulls/1"},"html":{"href":"https://github.com/in-toto/ITE/pull/1"},"issue":{"href":"https://api.github.com/repos/in-toto/ITE/issues/1"},"comments":{"href":"https://api.github.com/repos/in-toto/ITE/issues/1/comments"},"review_comments":{"href":"https://api.github.com/repos/in-toto/ITE/pulls/1/comments"},"review_comment":{"href":"https://api.github.com/repos/in-toto/ITE/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/in-toto/ITE/pulls/1/commits"},"statuses":{"href":"https://api.github.com/repos/in-toto/ITE/statuses/bdf64cb86b7e28d737bb372d972cd9f040cd996b"}},"author_association":"CONTRIBUTOR"}}
{"actor":{"display_login":"reza-curtmola"}}