{"action":"created","issue":{"url":"https://api.github.com/repos/KiCad/kicad-doc/issues/131","labels_url":"https://api.github.com/repos/KiCad/kicad-doc/issues/131/labels{/name}","comments_url":"https://api.github.com/repos/KiCad/kicad-doc/issues/131/comments","events_url":"https://api.github.com/repos/KiCad/kicad-doc/issues/131/events","html_url":"https://github.com/KiCad/kicad-doc/issues/131","id":97226268,"number":131,"title":"Improve documentation forewords","user":{"login":"Caerbannog","id":242172,"avatar_url":"https://avatars.githubusercontent.com/u/242172?v=3","gravatar_id":"","url":"https://api.github.com/users/Caerbannog","html_url":"https://github.com/Caerbannog","followers_url":"https://api.github.com/users/Caerbannog/followers","following_url":"https://api.github.com/users/Caerbannog/following{/other_user}","gists_url":"https://api.github.com/users/Caerbannog/gists{/gist_id}","starred_url":"https://api.github.com/users/Caerbannog/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Caerbannog/subscriptions","organizations_url":"https://api.github.com/users/Caerbannog/orgs","repos_url":"https://api.github.com/users/Caerbannog/repos","events_url":"https://api.github.com/users/Caerbannog/events{/privacy}","received_events_url":"https://api.github.com/users/Caerbannog/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/KiCad/kicad-doc/milestones/1","html_url":"https://github.com/KiCad/kicad-doc/milestones/4.0.0","labels_url":"https://api.github.com/repos/KiCad/kicad-doc/milestones/1/labels","id":1324563,"number":1,"title":"4.0.0","description":null,"creator":{"login":"nickoe","id":352202,"avatar_url":"https://avatars.githubusercontent.com/u/352202?v=3","gravatar_id":"","url":"https://api.github.com/users/nickoe","html_url":"https://github.com/nickoe","followers_url":"https://api.github.com/users/nickoe/followers","following_url":"https://api.github.com/users/nickoe/following{/other_user}","gists_url":"https://api.github.com/users/nickoe/gists{/gist_id}","starred_url":"https://api.github.com/users/nickoe/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nickoe/subscriptions","organizations_url":"https://api.github.com/users/nickoe/orgs","repos_url":"https://api.github.com/users/nickoe/repos","events_url":"https://api.github.com/users/nickoe/events{/privacy}","received_events_url":"https://api.github.com/users/nickoe/received_events","type":"User","site_admin":false},"open_issues":3,"closed_issues":0,"state":"open","created_at":"2015-09-25T21:35:47Z","updated_at":"2015-09-25T21:46:01Z","due_on":null,"closed_at":null},"comments":18,"created_at":"2015-07-25T13:16:53Z","updated_at":"2015-10-08T08:13:36Z","closed_at":null,"body":"Since the forewords is the first thing that people see, we might want to polish it.\r\nIt's mostly similar between documents, see [GSIK](http://ci.kicad-pcb.org/job/any-kicad-doc-head/ws/build-cmake/src/Getting_Started_in_KiCad/en/Getting_Started_in_KiCad.html) and [KiCad](http://ci.kicad-pcb.org/job/any-kicad-doc-head/ws/build-cmake/src/KiCad/en/KiCad.html).\r\n\r\nSuggestions:\r\n\r\n1. The document title is duplicated in bold. Remove it:\r\n   ```\r\nGUI Translation HOWTO\r\n=====================\r\n\r\n*GUI Translation HOWTO* => remove\r\n```\r\n2. Issue #75 discusses the \"Contributors\" lists. I propose to replace it with a link to the commit history. Or to have CMake generate a CONTRIBUTORS.txt because it's easier.\r\n3. The \"Feedback\" part should point to Github issues.\r\n4. Remove \"Acknowledgments\" because it's systematically empty.\r\n5. Publication date and software version is a good idea, but it's out of date. Suggestions of what CMake should generate?\r\n6. Should the \"Note for Mac users: ... support is ... experimental.\" be removed now?\r\n\r\nI will try to move quickly on these points when I have some feedback."},"comment":{"url":"https://api.github.com/repos/KiCad/kicad-doc/issues/comments/146452178","html_url":"https://github.com/KiCad/kicad-doc/issues/131#issuecomment-146452178","issue_url":"https://api.github.com/repos/KiCad/kicad-doc/issues/131","id":146452178,"user":{"login":"ciampix","id":372887,"avatar_url":"https://avatars.githubusercontent.com/u/372887?v=3","gravatar_id":"","url":"https://api.github.com/users/ciampix","html_url":"https://github.com/ciampix","followers_url":"https://api.github.com/users/ciampix/followers","following_url":"https://api.github.com/users/ciampix/following{/other_user}","gists_url":"https://api.github.com/users/ciampix/gists{/gist_id}","starred_url":"https://api.github.com/users/ciampix/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ciampix/subscriptions","organizations_url":"https://api.github.com/users/ciampix/orgs","repos_url":"https://api.github.com/users/ciampix/repos","events_url":"https://api.github.com/users/ciampix/events{/privacy}","received_events_url":"https://api.github.com/users/ciampix/received_events","type":"User","site_admin":false},"created_at":"2015-10-08T08:13:36Z","updated_at":"2015-10-08T08:13:36Z","body":"I like it. @nickoe? Any doubts? Drawbacks on rely on github? What do you think?"}}