{"action":"created","issue":{"url":"https://api.github.com/repos/plone/documentation/issues/548","repository_url":"https://api.github.com/repos/plone/documentation","labels_url":"https://api.github.com/repos/plone/documentation/issues/548/labels{/name}","comments_url":"https://api.github.com/repos/plone/documentation/issues/548/comments","events_url":"https://api.github.com/repos/plone/documentation/issues/548/events","html_url":"https://github.com/plone/documentation/issues/548","id":139420222,"number":548,"title":"line length in package documentation","user":{"login":"thet","id":170891,"avatar_url":"https://avatars.githubusercontent.com/u/170891?v=3","gravatar_id":"","url":"https://api.github.com/users/thet","html_url":"https://github.com/thet","followers_url":"https://api.github.com/users/thet/followers","following_url":"https://api.github.com/users/thet/following{/other_user}","gists_url":"https://api.github.com/users/thet/gists{/gist_id}","starred_url":"https://api.github.com/users/thet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thet/subscriptions","organizations_url":"https://api.github.com/users/thet/orgs","repos_url":"https://api.github.com/users/thet/repos","events_url":"https://api.github.com/users/thet/events{/privacy}","received_events_url":"https://api.github.com/users/thet/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2016-03-08T23:02:18Z","updated_at":"2016-03-08T23:17:17Z","closed_at":null,"body":"Until recently we always applied the PEP8 line length restriction to 79 columns also for CHANGES.rst and README.rst.\r\n\r\nIMO these files are documentation and should also apply the restructured text styleguide http://docs.plone.org/about/rst-styleguide.html#line-length-translations\r\n\r\nWe already have this mentioned in the Python styleguide: https://github.com/plone/documentation/blob/5.0/develop/styleguide/python.rst#line-length\r\n> [the 79 column line length rule] explicitly does not aply to documentation .rst files. For rst files, use semantic linebreaks.\r\n\r\nI propose to use _semantic linebreaks_ for all ``.rst`` files, including ``README.rst``, ``CHANGELOG.rst`` and even doctests. It's better for readability and it's more consistent too."},"comment":{"url":"https://api.github.com/repos/plone/documentation/issues/comments/194013198","html_url":"https://github.com/plone/documentation/issues/548#issuecomment-194013198","issue_url":"https://api.github.com/repos/plone/documentation/issues/548","id":194013198,"user":{"login":"thet","id":170891,"avatar_url":"https://avatars.githubusercontent.com/u/170891?v=3","gravatar_id":"","url":"https://api.github.com/users/thet","html_url":"https://github.com/thet","followers_url":"https://api.github.com/users/thet/followers","following_url":"https://api.github.com/users/thet/following{/other_user}","gists_url":"https://api.github.com/users/thet/gists{/gist_id}","starred_url":"https://api.github.com/users/thet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thet/subscriptions","organizations_url":"https://api.github.com/users/thet/orgs","repos_url":"https://api.github.com/users/thet/repos","events_url":"https://api.github.com/users/thet/events{/privacy}","received_events_url":"https://api.github.com/users/thet/received_events","type":"User","site_admin":false},"created_at":"2016-03-08T23:17:17Z","updated_at":"2016-03-08T23:17:17Z","body":"added a pull request for explicitly mentioning changes.rst and readme.rst: #549"}}