{"action":"created","issue":{"url":"https://api.github.com/repos/e-government-ua/i/issues/983","labels_url":"https://api.github.com/repos/e-government-ua/i/issues/983/labels{/name}","comments_url":"https://api.github.com/repos/e-government-ua/i/issues/983/comments","events_url":"https://api.github.com/repos/e-government-ua/i/issues/983/events","html_url":"https://github.com/e-government-ua/i/issues/983","id":119932689,"number":983,"title":"Перенести описание сервисов и параметров из доки по АПИ (с Вики) - в комментарии кода, по данным методам","user":{"login":"bvv4ik","id":4208821,"avatar_url":"https://avatars.githubusercontent.com/u/4208821?v=3","gravatar_id":"","url":"https://api.github.com/users/bvv4ik","html_url":"https://github.com/bvv4ik","followers_url":"https://api.github.com/users/bvv4ik/followers","following_url":"https://api.github.com/users/bvv4ik/following{/other_user}","gists_url":"https://api.github.com/users/bvv4ik/gists{/gist_id}","starred_url":"https://api.github.com/users/bvv4ik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bvv4ik/subscriptions","organizations_url":"https://api.github.com/users/bvv4ik/orgs","repos_url":"https://api.github.com/users/bvv4ik/repos","events_url":"https://api.github.com/users/bvv4ik/events{/privacy}","received_events_url":"https://api.github.com/users/bvv4ik/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/e-government-ua/i/labels/active","name":"active","color":"eb6420"},{"url":"https://api.github.com/repos/e-government-ua/i/labels/_wf-base","name":"_wf-base","color":"0052cc"},{"url":"https://api.github.com/repos/e-government-ua/i/labels/_wf-central","name":"_wf-central","color":"0052cc"}],"state":"open","locked":false,"assignee":{"login":"tivv","id":425183,"avatar_url":"https://avatars.githubusercontent.com/u/425183?v=3","gravatar_id":"","url":"https://api.github.com/users/tivv","html_url":"https://github.com/tivv","followers_url":"https://api.github.com/users/tivv/followers","following_url":"https://api.github.com/users/tivv/following{/other_user}","gists_url":"https://api.github.com/users/tivv/gists{/gist_id}","starred_url":"https://api.github.com/users/tivv/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tivv/subscriptions","organizations_url":"https://api.github.com/users/tivv/orgs","repos_url":"https://api.github.com/users/tivv/repos","events_url":"https://api.github.com/users/tivv/events{/privacy}","received_events_url":"https://api.github.com/users/tivv/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/e-government-ua/i/milestones/8","html_url":"https://github.com/e-government-ua/i/milestones/Organization","labels_url":"https://api.github.com/repos/e-government-ua/i/milestones/8/labels","id":1063355,"number":8,"title":"Organization","description":"Организация среды разработки (репозиторий,структуриры задач,описания)","creator":{"login":"bvv4ik","id":4208821,"avatar_url":"https://avatars.githubusercontent.com/u/4208821?v=3","gravatar_id":"","url":"https://api.github.com/users/bvv4ik","html_url":"https://github.com/bvv4ik","followers_url":"https://api.github.com/users/bvv4ik/followers","following_url":"https://api.github.com/users/bvv4ik/following{/other_user}","gists_url":"https://api.github.com/users/bvv4ik/gists{/gist_id}","starred_url":"https://api.github.com/users/bvv4ik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bvv4ik/subscriptions","organizations_url":"https://api.github.com/users/bvv4ik/orgs","repos_url":"https://api.github.com/users/bvv4ik/repos","events_url":"https://api.github.com/users/bvv4ik/events{/privacy}","received_events_url":"https://api.github.com/users/bvv4ik/received_events","type":"User","site_admin":false},"open_issues":7,"closed_issues":18,"state":"open","created_at":"2015-04-11T19:29:57Z","updated_at":"2015-12-17T17:49:33Z","due_on":null,"closed_at":null},"comments":57,"created_at":"2015-12-02T12:37:38Z","updated_at":"2015-12-27T13:50:11Z","closed_at":null,"body":"Взять описание отсюда:\r\nhttps://github.com/e-government-ua/i/blob/test/docs/specification.md\r\n\r\nи после занесения описания сервиса(с указанием метода)+описанием параметров+описанием ответа (с примером)\r\n\r\n- запушитьв ветку и дождавшись сборки, убедиться что все появилось в:\r\nhttps://jenkins.igov.org.ua//view/new/job/central_alpha/ws/wf-base/target/site/apidocs/index.html\r\nhttps://jenkins.igov.org.ua//view/new/job/central_alpha/ws/wf-central/target/site/apidocs/index.html"},"comment":{"url":"https://api.github.com/repos/e-government-ua/i/issues/comments/167414396","html_url":"https://github.com/e-government-ua/i/issues/983#issuecomment-167414396","issue_url":"https://api.github.com/repos/e-government-ua/i/issues/983","id":167414396,"user":{"login":"bvv4ik","id":4208821,"avatar_url":"https://avatars.githubusercontent.com/u/4208821?v=3","gravatar_id":"","url":"https://api.github.com/users/bvv4ik","html_url":"https://github.com/bvv4ik","followers_url":"https://api.github.com/users/bvv4ik/followers","following_url":"https://api.github.com/users/bvv4ik/following{/other_user}","gists_url":"https://api.github.com/users/bvv4ik/gists{/gist_id}","starred_url":"https://api.github.com/users/bvv4ik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bvv4ik/subscriptions","organizations_url":"https://api.github.com/users/bvv4ik/orgs","repos_url":"https://api.github.com/users/bvv4ik/repos","events_url":"https://api.github.com/users/bvv4ik/events{/privacy}","received_events_url":"https://api.github.com/users/bvv4ik/received_events","type":"User","site_admin":false},"created_at":"2015-12-27T13:50:11Z","updated_at":"2015-12-27T13:50:11Z","body":"@kr110666kai\r\n\"Может я перенесу формирование файлов документации из /target/generated-docs, а то после неудачной сборки документация недоступна ( уже удалена, но еще не сформированя )\"\r\nМожно сделать следующим образом (чтоб не удлинять по времени и бе того длинный процесс по сборке):\r\nВынести формирование доков в отдельную джобу(если это возможно, а из этой джобы убрать, и только включить каскадный запуск той джобы\r\nтогда проблем не будет с этим... и скорость сборки увеличится (не ожидая сборки доков)\r\n\r\nНО, важнее как-то решить другой обнаружевшийся мной момент:\r\n\r\nувидел повально такую картину:\r\n    private static final String noteGetTasksByAssignee = noteController + \"Загрузка задач из Activiti #####\\n\\n\"\r\n\t\t+ \"HTTP Context: https://server:port/wf/service/rest/tasks/{assignee}\\n\\n\"\r\n\t\t+ \"- assignee - Владелец\\n\"\r\n\t\t+ \"- nID_Subject - ID авторизированого субъекта (добавляется в запрос автоматически после аутентификации пользователя)\\n\\n\"\r\n\t\t+ \"Request:\\n\"\r\n\t\t+ \"https://test.region.igov.org.ua/wf/service/rest/tasks/kermit\\n\\n\"\r\n\t\t+ \"Response:\\n\"\r\n\t\t+ noteCODEJSON\r\n\t\t+ \"    [\\n\"\r\n\r\nтут:\r\n1) почему-то описание параметров не берется из стандартных анотаций по параметрам (а это важно очень, чтоб не дублировать в нескольких местах для нескольких генераторов)\r\n2) это все вынесено в отдельные переменные, что нельзя делать... это должны быть анотакии а не хардкод... (разница в том, что при компиляции анотации могути легко убираться а вот этот хардкод - нет)\r\n3) при сборке строки используется составляющая переменная, типа \"noteController + \", чего тоже плохо... ведь описание контроллера должно быть в одном месте, тоже в анотации а не вот таким вот образом добавляться к описанию каждого метода/сервиса\r\nт.е. вместо:\r\nprivate static final String noteController = \"#####  Электронная эскалация. \";\r\nдолжно быть что-то вроде:\r\n@Controller\r\n@Api(tags = { \"ActivitiRestTaskController\" }, description = \"#####  Электронная эскалация.\")\r\n"}}