{"action":"created","issue":{"url":"https://api.github.com/repos/tessel/t2-cli/issues/560","repository_url":"https://api.github.com/repos/tessel/t2-cli","labels_url":"https://api.github.com/repos/tessel/t2-cli/issues/560/labels{/name}","comments_url":"https://api.github.com/repos/tessel/t2-cli/issues/560/comments","events_url":"https://api.github.com/repos/tessel/t2-cli/issues/560/events","html_url":"https://github.com/tessel/t2-cli/issues/560","id":133015997,"number":560,"title":"[contributing] Make it easier for newcomers to understand & start hacking on the CLI","user":{"login":"flaki","id":2089432,"avatar_url":"https://avatars.githubusercontent.com/u/2089432?v=3","gravatar_id":"","url":"https://api.github.com/users/flaki","html_url":"https://github.com/flaki","followers_url":"https://api.github.com/users/flaki/followers","following_url":"https://api.github.com/users/flaki/following{/other_user}","gists_url":"https://api.github.com/users/flaki/gists{/gist_id}","starred_url":"https://api.github.com/users/flaki/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/flaki/subscriptions","organizations_url":"https://api.github.com/users/flaki/orgs","repos_url":"https://api.github.com/users/flaki/repos","events_url":"https://api.github.com/users/flaki/events{/privacy}","received_events_url":"https://api.github.com/users/flaki/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2016-02-11T16:10:44Z","updated_at":"2016-04-20T13:38:38Z","closed_at":null,"body":"So when I got back into in the saddle with the Tessel 2 (especially with the CLI), I could practically be considered as a newcomer, I had to re-learn and re-discover the whole of the CLI & the source.\r\n\r\nWhat I realized was that it was suprisingly hard to \"uncover\" the \"magic\" the CLI was hiding/abstracting away — but what it was doing most of the time is that it was channeling commands to the T2's OS. Those commands were:\r\n - new to me (as I've never worked with OpenWRT before, at least not in this depth), and\r\n - suprisingly hard to track (as in, in what situation what commands get executed)\r\n\r\nI think, as new folks come onboard shortly we should be focusing not just on making it easy for them to work _with_ the Tessel 2 (as in, push code and operate it via the CLI), but also work *on* the Tessel 2, so they can jump in and improve the tooling itself (especially the CLI).\r\n\r\nFirst step of that for me was to create some new debugging properties to better see what's going on:\r\nhttps://github.com/flaki/t2-cli/tree/command-debug\r\n\r\nAlso, I was documenting my fumbling around T2 & OpenWRT-world, and this is what came out of it:\r\nhttps://gist.github.com/flaki/a1efdb438292dd8c56c3\r\n@Frijol - do you think this should live somewhere better-discoverable? If yes, where?\r\n@HipsterBrown - please add anything in here you yourself have came across while developing the AP mode. ;)\r\n\r\nSome other commands complementing the CLI would be nice as well, I'll be adding those to their own respective issues."},"comment":{"url":"https://api.github.com/repos/tessel/t2-cli/issues/comments/212426946","html_url":"https://github.com/tessel/t2-cli/issues/560#issuecomment-212426946","issue_url":"https://api.github.com/repos/tessel/t2-cli/issues/560","id":212426946,"user":{"login":"tikurahul","id":624211,"avatar_url":"https://avatars.githubusercontent.com/u/624211?v=3","gravatar_id":"","url":"https://api.github.com/users/tikurahul","html_url":"https://github.com/tikurahul","followers_url":"https://api.github.com/users/tikurahul/followers","following_url":"https://api.github.com/users/tikurahul/following{/other_user}","gists_url":"https://api.github.com/users/tikurahul/gists{/gist_id}","starred_url":"https://api.github.com/users/tikurahul/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tikurahul/subscriptions","organizations_url":"https://api.github.com/users/tikurahul/orgs","repos_url":"https://api.github.com/users/tikurahul/repos","events_url":"https://api.github.com/users/tikurahul/events{/privacy}","received_events_url":"https://api.github.com/users/tikurahul/received_events","type":"User","site_admin":false},"created_at":"2016-04-20T13:38:38Z","updated_at":"2016-04-20T13:38:38Z","body":"I just saw this gist, and this makes things so much easier to understand. This is awesome. "}}