{"action":"created","issue":{"url":"https://api.github.com/repos/pfultz2/Fit/issues/144","repository_url":"https://api.github.com/repos/pfultz2/Fit","labels_url":"https://api.github.com/repos/pfultz2/Fit/issues/144/labels{/name}","comments_url":"https://api.github.com/repos/pfultz2/Fit/issues/144/comments","events_url":"https://api.github.com/repos/pfultz2/Fit/issues/144/events","html_url":"https://github.com/pfultz2/Fit/issues/144","id":140297756,"number":144,"title":"[Doc] Examples should be copy-pasteable","user":{"login":"ldionne","id":700834,"avatar_url":"https://avatars.githubusercontent.com/u/700834?v=3","gravatar_id":"","url":"https://api.github.com/users/ldionne","html_url":"https://github.com/ldionne","followers_url":"https://api.github.com/users/ldionne/followers","following_url":"https://api.github.com/users/ldionne/following{/other_user}","gists_url":"https://api.github.com/users/ldionne/gists{/gist_id}","starred_url":"https://api.github.com/users/ldionne/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ldionne/subscriptions","organizations_url":"https://api.github.com/users/ldionne/orgs","repos_url":"https://api.github.com/users/ldionne/repos","events_url":"https://api.github.com/users/ldionne/events{/privacy}","received_events_url":"https://api.github.com/users/ldionne/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/pfultz2/Fit/labels/document","name":"document","color":"fef2c0"},{"url":"https://api.github.com/repos/pfultz2/Fit/labels/enhancement","name":"enhancement","color":"84b6eb"},{"url":"https://api.github.com/repos/pfultz2/Fit/labels/review","name":"review","color":"fad8c7"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-03-11T21:33:34Z","updated_at":"2016-03-26T02:10:22Z","closed_at":"2016-03-26T02:10:22Z","body":"I find it very useful to be able to copy/paste examples from the documentation and have them work as-is. Having to tinker with an example like adding includes, adding `using namespace fit` or similar things is annoying and counter productive."},"comment":{"url":"https://api.github.com/repos/pfultz2/Fit/issues/comments/201669844","html_url":"https://github.com/pfultz2/Fit/issues/144#issuecomment-201669844","issue_url":"https://api.github.com/repos/pfultz2/Fit/issues/144","id":201669844,"user":{"login":"pfultz2","id":1306044,"avatar_url":"https://avatars.githubusercontent.com/u/1306044?v=3","gravatar_id":"","url":"https://api.github.com/users/pfultz2","html_url":"https://github.com/pfultz2","followers_url":"https://api.github.com/users/pfultz2/followers","following_url":"https://api.github.com/users/pfultz2/following{/other_user}","gists_url":"https://api.github.com/users/pfultz2/gists{/gist_id}","starred_url":"https://api.github.com/users/pfultz2/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pfultz2/subscriptions","organizations_url":"https://api.github.com/users/pfultz2/orgs","repos_url":"https://api.github.com/users/pfultz2/repos","events_url":"https://api.github.com/users/pfultz2/events{/privacy}","received_events_url":"https://api.github.com/users/pfultz2/received_events","type":"User","site_admin":false},"created_at":"2016-03-26T02:10:22Z","updated_at":"2016-03-26T02:10:22Z","body":"All the examples in the reference are now copy and pasteable. The tutorial doesn't have them although I am thinking about pulling them directly from the example directory. I am thinking about switching to sphinx for documentation, which might make this easier. I am going to close this for now. "}}