{"action":"created","issue":{"url":"https://api.github.com/repos/isobar-idev/code-standards/issues/49","labels_url":"https://api.github.com/repos/isobar-idev/code-standards/issues/49/labels{/name}","comments_url":"https://api.github.com/repos/isobar-idev/code-standards/issues/49/comments","events_url":"https://api.github.com/repos/isobar-idev/code-standards/issues/49/events","html_url":"https://github.com/isobar-idev/code-standards/issues/49","id":14621469,"number":49,"title":"Idea: Pull most links out to separate section","user":{"login":"rcherny","id":962342,"avatar_url":"https://avatars.githubusercontent.com/u/962342?v=3","gravatar_id":"","url":"https://api.github.com/users/rcherny","html_url":"https://github.com/rcherny","followers_url":"https://api.github.com/users/rcherny/followers","following_url":"https://api.github.com/users/rcherny/following{/other_user}","gists_url":"https://api.github.com/users/rcherny/gists{/gist_id}","starred_url":"https://api.github.com/users/rcherny/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rcherny/subscriptions","organizations_url":"https://api.github.com/users/rcherny/orgs","repos_url":"https://api.github.com/users/rcherny/repos","events_url":"https://api.github.com/users/rcherny/events{/privacy}","received_events_url":"https://api.github.com/users/rcherny/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/isobar-idev/code-standards/labels/Discuss","name":"Discuss","color":"d7e102"},{"url":"https://api.github.com/repos/isobar-idev/code-standards/labels/Enhancement","name":"Enhancement","color":"02e10c"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/isobar-idev/code-standards/milestones/3","html_url":"https://github.com/isobar-idev/code-standards/milestones/Standards.Future","labels_url":"https://api.github.com/repos/isobar-idev/code-standards/milestones/3/labels","id":338836,"number":3,"title":"Standards.Future","description":"Future or longer term enhancements. Sometimes points for discussion.","creator":{"login":"rcherny","id":962342,"avatar_url":"https://avatars.githubusercontent.com/u/962342?v=3","gravatar_id":"","url":"https://api.github.com/users/rcherny","html_url":"https://github.com/rcherny","followers_url":"https://api.github.com/users/rcherny/followers","following_url":"https://api.github.com/users/rcherny/following{/other_user}","gists_url":"https://api.github.com/users/rcherny/gists{/gist_id}","starred_url":"https://api.github.com/users/rcherny/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rcherny/subscriptions","organizations_url":"https://api.github.com/users/rcherny/orgs","repos_url":"https://api.github.com/users/rcherny/repos","events_url":"https://api.github.com/users/rcherny/events{/privacy}","received_events_url":"https://api.github.com/users/rcherny/received_events","type":"User","site_admin":false},"open_issues":17,"closed_issues":0,"state":"open","created_at":"2013-05-22T00:59:13Z","updated_at":"2015-05-22T16:33:14Z","due_on":null,"closed_at":null},"comments":4,"created_at":"2013-05-22T12:58:40Z","updated_at":"2015-08-06T16:23:29Z","closed_at":null,"body":"I'm concerned about link rot and things like that. Also, in terms of resources, they are fluid and a dime a dozen (sometimes).\r\n\r\nEffectively I'm thinking that we start to get really careful about what we allow as a hard coded link in the standards doc going forward.\r\n\r\nI'm thinking that perhaps the things like the Appendix or possibly even references or sources for each section in the document be pulled out into pages similar to this:\r\n\r\nhttps://github.com/isobar-idev/code-standards/wiki/Useful-Links-and-Resources\r\n\r\nNot in one page, and probably Markdown pages in an actual Repo, since Github Wikis, as I understand it, are source control challenged.\r\n\r\nJust a thought. We might have a \"useful resources\" link at the end of each section, or something along those lines.\r\n\r\nMy reasoning is that links come and go, as do valuable resources, but the Standards Doc content should be a little more vetted, a little more persistant, even though it will continue (hopefully, but let's be realistic) to be a living document.\r\n\r\nI'd want the resources to be even more fluid and easy to change. Also, it will drive traffic to our Github.\r\n\r\nThoughts? Opinions? Feelings? Reactions? Good? Bad? Indifferent?\r\n"},"comment":{"url":"https://api.github.com/repos/isobar-idev/code-standards/issues/comments/128425925","html_url":"https://github.com/isobar-idev/code-standards/issues/49#issuecomment-128425925","issue_url":"https://api.github.com/repos/isobar-idev/code-standards/issues/49","id":128425925,"user":{"login":"dforesman","id":962283,"avatar_url":"https://avatars.githubusercontent.com/u/962283?v=3","gravatar_id":"","url":"https://api.github.com/users/dforesman","html_url":"https://github.com/dforesman","followers_url":"https://api.github.com/users/dforesman/followers","following_url":"https://api.github.com/users/dforesman/following{/other_user}","gists_url":"https://api.github.com/users/dforesman/gists{/gist_id}","starred_url":"https://api.github.com/users/dforesman/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dforesman/subscriptions","organizations_url":"https://api.github.com/users/dforesman/orgs","repos_url":"https://api.github.com/users/dforesman/repos","events_url":"https://api.github.com/users/dforesman/events{/privacy}","received_events_url":"https://api.github.com/users/dforesman/received_events","type":"User","site_admin":false},"created_at":"2015-08-06T16:23:29Z","updated_at":"2015-08-06T16:23:29Z","body":"I worry about linking directly to specs, as so often the _spec_ and the _actual browser implementations_ differ. Not to mention that w3c spec pages are horrific to read.\r\n\r\nI've investigated some options that could help us deal with link rot problem, logged in https://github.com/isobar-idev/code-standards/issues/123\r\n\r\nRegardless of whether we pull links out into a separate section, or leave them inline, an automated link-checker could be useful."}}