{"action":"opened","issue":{"url":"https://api.github.com/repos/Kitware/tangelo/issues/517","labels_url":"https://api.github.com/repos/Kitware/tangelo/issues/517/labels{/name}","comments_url":"https://api.github.com/repos/Kitware/tangelo/issues/517/comments","events_url":"https://api.github.com/repos/Kitware/tangelo/issues/517/events","html_url":"https://github.com/Kitware/tangelo/issues/517","id":106844175,"number":517,"title":"Move coding style guidelines to somewhere more appropriate","user":{"login":"ronichoudhury","id":2903332,"avatar_url":"https://avatars.githubusercontent.com/u/2903332?v=3","gravatar_id":"","url":"https://api.github.com/users/ronichoudhury","html_url":"https://github.com/ronichoudhury","followers_url":"https://api.github.com/users/ronichoudhury/followers","following_url":"https://api.github.com/users/ronichoudhury/following{/other_user}","gists_url":"https://api.github.com/users/ronichoudhury/gists{/gist_id}","starred_url":"https://api.github.com/users/ronichoudhury/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ronichoudhury/subscriptions","organizations_url":"https://api.github.com/users/ronichoudhury/orgs","repos_url":"https://api.github.com/users/ronichoudhury/repos","events_url":"https://api.github.com/users/ronichoudhury/events{/privacy}","received_events_url":"https://api.github.com/users/ronichoudhury/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-09-16T19:20:53Z","updated_at":"2015-09-16T19:20:53Z","closed_at":null,"body":"@manthey points out that the Tangelo docs include \"Coding Style Guidelines\" that don't describe the Python code style in the Tangelo codebase.  This is because that section is meant for *JavaScript* code that might be included in Tangelo.  The section doesn't belong here for a few reasons:\r\n\r\n1. There is no corresponding style guide for Python code, and the existing section doesn't make clear that it's for JavaScript code.\r\n\r\n2. Tangelo no longer makes a blurry distinction between core and \"other\" - \"other\" now clearly belonging in Tangelo plugins, making it somewhat less critical that they follow the Tangelo style guides.  If a plugin were to be included in Tangelo's bundled plugin list, the style guide would apply strictly again.\r\n\r\nThere are a couple of ways to fix this.  One is to make clear in the title of the existing section that it's meant for JavaScript code.  Better would be to rip the whole section out and put it in CONTRIBUTING.md or somewhere else.  If we do that, we might need to include a Python style guide as well.  However, my intuition tells me that addition wouldn't need to be as long as the JavaScript rules, since Python style has less variation in the wild, due to the existence of \"Pythonicness\", etc."}}