{"action":"created","comment":{"url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/comments/70607259","id":70607259,"diff_hunk":"@@ -0,0 +1,82 @@\n+# Tagging\n+\n+Прототип на английском: [tagging guide][tagging]. Здесь и далее следует\n+его вольное изложение и адаптация на русском.\n+\n+  [tagging]: https://github.com/martin-eden/tagging_guideline/blob/master/tagging_guide.MD\n+\n+В описании изменений рекомендуется использовать метки (tags, тэги).\n+Это просто некий текст в квадратных скобках `[]`. Смысл в том, чтобы можно\n+было найти все относящиеся к этой метке изменения простым grep.\n+\n+    [.^][readme] Reworded some lines.\n+    [?+][string-concatter] Added experimental garbage-collection heuristic.\n+    [!*] Debugged! (At least hope so.) Just want to mark this state...\n+    [/] [string/from_file] renamed to [file/as_string].\n+\n+## Дайджест изменений\n+\n+В начале сообщения может быть тэг дайджеста изменений со спецсимволами.\n+Каждый спецсимвол - опциональный флаг. То есть может быть упомянут не\n+более чем единожды. Значение их следующее:\n+\n+* Важность:\n+    * `.` -- мелочь. Изменеие не оказывает практически никакого влияния,\n+      кроме эстетического\n+    * `!` -- важно. Важное изменение, которое ломает/правит целые\n+      подсистемы функционала\n+\n+* Направление:\n+    * `?` -- эксперимент. Изменение содержит идею, требующую дальнейшей\n+      проверки.\n+    * `^` -- улучшение. Это когда с внешней точки зрения ничего не поменялось,\n+      но внутри код стал быстрее/красивее.\n+    * `*` -- исправление ошибки. Это когда с внешней точки зрения код\n+      вдруг стал работать так, как и предполагается. То есть исправление,\n+      не изменяющее интерфейс ввода/вывода.\n+\n+* Изменения кода:\n+    * `+` -- добавление. Что-то добавлено. Новая функция, новый файл,\n+      новая подсистема...\n+    * `-` -- что-то удалено насовсем. Обычно что-нибудь ненужное.\n+    * `/` -- что-то переименовано или перемещено. Например, изменено\n+      имя экспортируемой функции. Или в коде используется функция с\n+      другим именем. Или файл переименован-перемещён.\n+\n+      То есть, исправление, возможно изменяющее интерфейс ввода-вывода,\n+      но не изменяющее функционал.\n+\n+      Чтобы даже через год разработки, по сообщениям можно было\n+      восстановить цепочку изменений, *не забывайте указывать в\n+      сообщении как старое, так и новое имя в случае\n+      переименования/перемещения файлов*.\n+\n+      Можно ещё использовать\n+        * `>` -- импорт. Если код был откуда-то взят. В сообщении\n+          указать откуда. Иначе использовать `+`.\n+        * `<` -- экспорт. Код был вынесен в какой-то другой проект.\n+          В сообщении указать куда. Иначе использовать `-`.\n+\n+## Тэг имени\n+\n+После дайджеста изменений можно поставить тэг имени. В большинстве\n+случаев достаточно имени файла (без расширения, если это не приводит\n+к неоднозначности), но в крупных системах логичнее использовать\n+метку подсистемы, например `[cookie-parsing]`.\n+\n+Тут уж зависит от масштаба изменений. Если переколбашена вся подсистема\n+с полдюжиной файлов, логичнее в сделать один коммит с новой версией, а не\n+серию коммитов с переименованием/изменением каждого файла.\n+\n+## Примечания\n+\n+* Если под коммит не подходит под эти тэги, не используйте их. Напишите\n+внятный текст. Идея в том, чтобы иметь возможность маркировать\n+большинство изменений, но не все.\n+\n+* Синтаксисы дайжжеста изменений и тэгов имён независимы. Возможно,","path":"tag-guidelines.md","position":74,"original_position":77,"commit_id":"da9678292ca450f42236461591b913062f8fe5bb","original_commit_id":"d3bdf5e9609efd3b2008835b260c2f768e680d20","user":{"login":"yiavhgyl","id":20407182,"avatar_url":"https://avatars.githubusercontent.com/u/20407182?v=3","gravatar_id":"","url":"https://api.github.com/users/yiavhgyl","html_url":"https://github.com/yiavhgyl","followers_url":"https://api.github.com/users/yiavhgyl/followers","following_url":"https://api.github.com/users/yiavhgyl/following{/other_user}","gists_url":"https://api.github.com/users/yiavhgyl/gists{/gist_id}","starred_url":"https://api.github.com/users/yiavhgyl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yiavhgyl/subscriptions","organizations_url":"https://api.github.com/users/yiavhgyl/orgs","repos_url":"https://api.github.com/users/yiavhgyl/repos","events_url":"https://api.github.com/users/yiavhgyl/events{/privacy}","received_events_url":"https://api.github.com/users/yiavhgyl/received_events","type":"User","site_admin":false},"body":"Тут ещё опечатка: \"Если *под* коммит не подходит под эти тэги\". Выделенное -- удалить.","created_at":"2016-07-13T11:19:50Z","updated_at":"2016-07-13T11:19:50Z","html_url":"https://github.com/logiceditor-com/coding-guidelines/pull/5#discussion_r70607259","pull_request_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/5","_links":{"self":{"href":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/comments/70607259"},"html":{"href":"https://github.com/logiceditor-com/coding-guidelines/pull/5#discussion_r70607259"},"pull_request":{"href":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/5"}}},"pull_request":{"url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/5","id":77158694,"html_url":"https://github.com/logiceditor-com/coding-guidelines/pull/5","diff_url":"https://github.com/logiceditor-com/coding-guidelines/pull/5.diff","patch_url":"https://github.com/logiceditor-com/coding-guidelines/pull/5.patch","issue_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/issues/5","number":5,"state":"open","locked":false,"title":"Some suggestions from my side.","user":{"login":"yiavhgyl","id":20407182,"avatar_url":"https://avatars.githubusercontent.com/u/20407182?v=3","gravatar_id":"","url":"https://api.github.com/users/yiavhgyl","html_url":"https://github.com/yiavhgyl","followers_url":"https://api.github.com/users/yiavhgyl/followers","following_url":"https://api.github.com/users/yiavhgyl/following{/other_user}","gists_url":"https://api.github.com/users/yiavhgyl/gists{/gist_id}","starred_url":"https://api.github.com/users/yiavhgyl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yiavhgyl/subscriptions","organizations_url":"https://api.github.com/users/yiavhgyl/orgs","repos_url":"https://api.github.com/users/yiavhgyl/repos","events_url":"https://api.github.com/users/yiavhgyl/events{/privacy}","received_events_url":"https://api.github.com/users/yiavhgyl/received_events","type":"User","site_admin":false},"body":"Nicely separated commits","created_at":"2016-07-12T17:32:16Z","updated_at":"2016-07-13T11:19:50Z","closed_at":null,"merged_at":null,"merge_commit_sha":"754a76901cabd01a6841b684a8f7eb6f742ca803","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/5/commits","review_comments_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/5/comments","review_comment_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/comments{/number}","comments_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/issues/5/comments","statuses_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/statuses/da9678292ca450f42236461591b913062f8fe5bb","head":{"label":"yiavhgyl:nicely-separated-commits","ref":"nicely-separated-commits","sha":"da9678292ca450f42236461591b913062f8fe5bb","user":{"login":"yiavhgyl","id":20407182,"avatar_url":"https://avatars.githubusercontent.com/u/20407182?v=3","gravatar_id":"","url":"https://api.github.com/users/yiavhgyl","html_url":"https://github.com/yiavhgyl","followers_url":"https://api.github.com/users/yiavhgyl/followers","following_url":"https://api.github.com/users/yiavhgyl/following{/other_user}","gists_url":"https://api.github.com/users/yiavhgyl/gists{/gist_id}","starred_url":"https://api.github.com/users/yiavhgyl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yiavhgyl/subscriptions","organizations_url":"https://api.github.com/users/yiavhgyl/orgs","repos_url":"https://api.github.com/users/yiavhgyl/repos","events_url":"https://api.github.com/users/yiavhgyl/events{/privacy}","received_events_url":"https://api.github.com/users/yiavhgyl/received_events","type":"User","site_admin":false},"repo":{"id":63102894,"name":"coding-guidelines","full_name":"yiavhgyl/coding-guidelines","owner":{"login":"yiavhgyl","id":20407182,"avatar_url":"https://avatars.githubusercontent.com/u/20407182?v=3","gravatar_id":"","url":"https://api.github.com/users/yiavhgyl","html_url":"https://github.com/yiavhgyl","followers_url":"https://api.github.com/users/yiavhgyl/followers","following_url":"https://api.github.com/users/yiavhgyl/following{/other_user}","gists_url":"https://api.github.com/users/yiavhgyl/gists{/gist_id}","starred_url":"https://api.github.com/users/yiavhgyl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yiavhgyl/subscriptions","organizations_url":"https://api.github.com/users/yiavhgyl/orgs","repos_url":"https://api.github.com/users/yiavhgyl/repos","events_url":"https://api.github.com/users/yiavhgyl/events{/privacy}","received_events_url":"https://api.github.com/users/yiavhgyl/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/yiavhgyl/coding-guidelines","description":"LogicEditor coding guidelines","fork":true,"url":"https://api.github.com/repos/yiavhgyl/coding-guidelines","forks_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/forks","keys_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/keys{/key_id}","collaborators_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/teams","hooks_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/hooks","issue_events_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/issues/events{/number}","events_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/events","assignees_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/assignees{/user}","branches_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/branches{/branch}","tags_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/tags","blobs_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/git/refs{/sha}","trees_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/git/trees{/sha}","statuses_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/statuses/{sha}","languages_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/languages","stargazers_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/stargazers","contributors_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/contributors","subscribers_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/subscribers","subscription_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/subscription","commits_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/commits{/sha}","git_commits_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/git/commits{/sha}","comments_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/comments{/number}","issue_comment_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/issues/comments{/number}","contents_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/contents/{+path}","compare_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/compare/{base}...{head}","merges_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/merges","archive_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/downloads","issues_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/issues{/number}","pulls_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/pulls{/number}","milestones_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/milestones{/number}","notifications_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/labels{/name}","releases_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/releases{/id}","deployments_url":"https://api.github.com/repos/yiavhgyl/coding-guidelines/deployments","created_at":"2016-07-11T21:17:40Z","updated_at":"2015-04-08T17:53:57Z","pushed_at":"2016-07-12T17:29:22Z","git_url":"git://github.com/yiavhgyl/coding-guidelines.git","ssh_url":"git@github.com:yiavhgyl/coding-guidelines.git","clone_url":"https://github.com/yiavhgyl/coding-guidelines.git","svn_url":"https://github.com/yiavhgyl/coding-guidelines","homepage":"http://logiceditor.com","size":185,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"logiceditor-com:master","ref":"master","sha":"9890b7234b328d9dfa97779dc0954e9c4568e8f4","user":{"login":"logiceditor-com","id":535840,"avatar_url":"https://avatars.githubusercontent.com/u/535840?v=3","gravatar_id":"","url":"https://api.github.com/users/logiceditor-com","html_url":"https://github.com/logiceditor-com","followers_url":"https://api.github.com/users/logiceditor-com/followers","following_url":"https://api.github.com/users/logiceditor-com/following{/other_user}","gists_url":"https://api.github.com/users/logiceditor-com/gists{/gist_id}","starred_url":"https://api.github.com/users/logiceditor-com/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/logiceditor-com/subscriptions","organizations_url":"https://api.github.com/users/logiceditor-com/orgs","repos_url":"https://api.github.com/users/logiceditor-com/repos","events_url":"https://api.github.com/users/logiceditor-com/events{/privacy}","received_events_url":"https://api.github.com/users/logiceditor-com/received_events","type":"Organization","site_admin":false},"repo":{"id":2239711,"name":"coding-guidelines","full_name":"logiceditor-com/coding-guidelines","owner":{"login":"logiceditor-com","id":535840,"avatar_url":"https://avatars.githubusercontent.com/u/535840?v=3","gravatar_id":"","url":"https://api.github.com/users/logiceditor-com","html_url":"https://github.com/logiceditor-com","followers_url":"https://api.github.com/users/logiceditor-com/followers","following_url":"https://api.github.com/users/logiceditor-com/following{/other_user}","gists_url":"https://api.github.com/users/logiceditor-com/gists{/gist_id}","starred_url":"https://api.github.com/users/logiceditor-com/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/logiceditor-com/subscriptions","organizations_url":"https://api.github.com/users/logiceditor-com/orgs","repos_url":"https://api.github.com/users/logiceditor-com/repos","events_url":"https://api.github.com/users/logiceditor-com/events{/privacy}","received_events_url":"https://api.github.com/users/logiceditor-com/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/logiceditor-com/coding-guidelines","description":"LogicEditor coding guidelines","fork":false,"url":"https://api.github.com/repos/logiceditor-com/coding-guidelines","forks_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/forks","keys_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/keys{/key_id}","collaborators_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/teams","hooks_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/hooks","issue_events_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/issues/events{/number}","events_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/events","assignees_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/assignees{/user}","branches_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/branches{/branch}","tags_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/tags","blobs_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/git/refs{/sha}","trees_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/git/trees{/sha}","statuses_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/statuses/{sha}","languages_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/languages","stargazers_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/stargazers","contributors_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/contributors","subscribers_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/subscribers","subscription_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/subscription","commits_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/commits{/sha}","git_commits_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/git/commits{/sha}","comments_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/comments{/number}","issue_comment_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/issues/comments{/number}","contents_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/contents/{+path}","compare_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/compare/{base}...{head}","merges_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/merges","archive_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/downloads","issues_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/issues{/number}","pulls_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls{/number}","milestones_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/milestones{/number}","notifications_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/labels{/name}","releases_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/releases{/id}","deployments_url":"https://api.github.com/repos/logiceditor-com/coding-guidelines/deployments","created_at":"2011-08-20T16:41:54Z","updated_at":"2015-04-08T17:53:57Z","pushed_at":"2016-07-12T17:32:16Z","git_url":"git://github.com/logiceditor-com/coding-guidelines.git","ssh_url":"git@github.com:logiceditor-com/coding-guidelines.git","clone_url":"https://github.com/logiceditor-com/coding-guidelines.git","svn_url":"https://github.com/logiceditor-com/coding-guidelines","homepage":"http://logiceditor.com","size":854,"stargazers_count":7,"watchers_count":7,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":8,"mirror_url":null,"open_issues_count":1,"forks":8,"open_issues":1,"watchers":7,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/5"},"html":{"href":"https://github.com/logiceditor-com/coding-guidelines/pull/5"},"issue":{"href":"https://api.github.com/repos/logiceditor-com/coding-guidelines/issues/5"},"comments":{"href":"https://api.github.com/repos/logiceditor-com/coding-guidelines/issues/5/comments"},"review_comments":{"href":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/5/comments"},"review_comment":{"href":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/logiceditor-com/coding-guidelines/pulls/5/commits"},"statuses":{"href":"https://api.github.com/repos/logiceditor-com/coding-guidelines/statuses/da9678292ca450f42236461591b913062f8fe5bb"}}}}
{"actor":{"display_login":"yiavhgyl"}}