{"action":"created","issue":{"url":"https://api.github.com/repos/gonum/matrix/issues/282","labels_url":"https://api.github.com/repos/gonum/matrix/issues/282/labels{/name}","comments_url":"https://api.github.com/repos/gonum/matrix/issues/282/comments","events_url":"https://api.github.com/repos/gonum/matrix/issues/282/events","html_url":"https://github.com/gonum/matrix/issues/282","id":113099253,"number":282,"title":"matrix/{,cmat128}: add package documentation","user":{"login":"kortschak","id":275221,"avatar_url":"https://avatars.githubusercontent.com/u/275221?v=3","gravatar_id":"","url":"https://api.github.com/users/kortschak","html_url":"https://github.com/kortschak","followers_url":"https://api.github.com/users/kortschak/followers","following_url":"https://api.github.com/users/kortschak/following{/other_user}","gists_url":"https://api.github.com/users/kortschak/gists{/gist_id}","starred_url":"https://api.github.com/users/kortschak/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kortschak/subscriptions","organizations_url":"https://api.github.com/users/kortschak/orgs","repos_url":"https://api.github.com/users/kortschak/repos","events_url":"https://api.github.com/users/kortschak/events{/privacy}","received_events_url":"https://api.github.com/users/kortschak/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-10-23T20:58:25Z","updated_at":"2015-10-24T05:39:00Z","closed_at":null,"body":"See https://github.com/gonum/matrix/pull/281#issuecomment-150608626 and https://github.com/gonum/matrix/pull/281#issuecomment-150679516.\r\n\r\nThe idea of doing text munging does not appeal (we already do too much of this elsewhere and I don't want to add to that). I propose we write a matrix/gendoc.go (with `//+build ignore`) that holds the canonical package documentation for each of matrix, mat64 and cmat128 as a text template and have it emit doc.go for each of the three packages. Along with this we should add a go generate test for travis the same is exists in gonum/blas.\r\n\r\nTo start this we need to sort out what are common sections and what are package specific.\r\n\r\n\\cc @btracey "},"comment":{"url":"https://api.github.com/repos/gonum/matrix/issues/comments/150758774","html_url":"https://github.com/gonum/matrix/issues/282#issuecomment-150758774","issue_url":"https://api.github.com/repos/gonum/matrix/issues/282","id":150758774,"user":{"login":"btracey","id":3680859,"avatar_url":"https://avatars.githubusercontent.com/u/3680859?v=3","gravatar_id":"","url":"https://api.github.com/users/btracey","html_url":"https://github.com/btracey","followers_url":"https://api.github.com/users/btracey/followers","following_url":"https://api.github.com/users/btracey/following{/other_user}","gists_url":"https://api.github.com/users/btracey/gists{/gist_id}","starred_url":"https://api.github.com/users/btracey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/btracey/subscriptions","organizations_url":"https://api.github.com/users/btracey/orgs","repos_url":"https://api.github.com/users/btracey/repos","events_url":"https://api.github.com/users/btracey/events{/privacy}","received_events_url":"https://api.github.com/users/btracey/received_events","type":"User","site_admin":false},"created_at":"2015-10-24T05:39:00Z","updated_at":"2015-10-24T05:39:00Z","body":"SGTM. I would recommend we flesh out cmat a little more before we answer this (for example, deciding on #284 )"}}