{"action":"created","issue":{"url":"https://api.github.com/repos/elm-lang/core/issues/296","repository_url":"https://api.github.com/repos/elm-lang/core","labels_url":"https://api.github.com/repos/elm-lang/core/issues/296/labels{/name}","comments_url":"https://api.github.com/repos/elm-lang/core/issues/296/comments","events_url":"https://api.github.com/repos/elm-lang/core/issues/296/events","html_url":"https://github.com/elm-lang/core/issues/296","id":95232212,"number":296,"title":"Documentation and Design: Transform2D","user":{"login":"maxsnew","id":1479741,"avatar_url":"https://avatars.githubusercontent.com/u/1479741?v=3","gravatar_id":"","url":"https://api.github.com/users/maxsnew","html_url":"https://github.com/maxsnew","followers_url":"https://api.github.com/users/maxsnew/followers","following_url":"https://api.github.com/users/maxsnew/following{/other_user}","gists_url":"https://api.github.com/users/maxsnew/gists{/gist_id}","starred_url":"https://api.github.com/users/maxsnew/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/maxsnew/subscriptions","organizations_url":"https://api.github.com/users/maxsnew/orgs","repos_url":"https://api.github.com/users/maxsnew/repos","events_url":"https://api.github.com/users/maxsnew/events{/privacy}","received_events_url":"https://api.github.com/users/maxsnew/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-07-15T16:12:36Z","updated_at":"2016-05-11T01:17:12Z","closed_at":"2016-05-11T01:17:12Z","body":"I think the `Transform2D` documentation is overly technical in that it emphasizes the underlying matrix representation too much. Here's a link for convenience http://package.elm-lang.org/packages/elm-lang/core/2.1.0/Transform2D.\r\n\r\n Even people familliar with some linear algebra might not be familiar with affine transformations and their representation as 3x3 matrices where the bottom row is (0 0 1).\r\n\r\nMost of it is pretty straightforward and easily explained but the really bad one in my opinion is \"Multiplication\" which doesn't even mention that multiplication of these matrices really means composition of the transformations that they represent. I think this function should be renamed to `compose`.\r\n\r\nAlso can we have pictures in documentation? They might be helpful here but maybe that's just over-complicating things.\r\n\r\nI'd be willing to work on this but I wanted to discuss it first esp. since it's a proposed API change."},"comment":{"url":"https://api.github.com/repos/elm-lang/core/issues/comments/218337424","html_url":"https://github.com/elm-lang/core/issues/296#issuecomment-218337424","issue_url":"https://api.github.com/repos/elm-lang/core/issues/296","id":218337424,"user":{"login":"evancz","id":1658058,"avatar_url":"https://avatars.githubusercontent.com/u/1658058?v=3","gravatar_id":"","url":"https://api.github.com/users/evancz","html_url":"https://github.com/evancz","followers_url":"https://api.github.com/users/evancz/followers","following_url":"https://api.github.com/users/evancz/following{/other_user}","gists_url":"https://api.github.com/users/evancz/gists{/gist_id}","starred_url":"https://api.github.com/users/evancz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/evancz/subscriptions","organizations_url":"https://api.github.com/users/evancz/orgs","repos_url":"https://api.github.com/users/evancz/repos","events_url":"https://api.github.com/users/evancz/events{/privacy}","received_events_url":"https://api.github.com/users/evancz/received_events","type":"User","site_admin":false},"created_at":"2016-05-11T01:17:12Z","updated_at":"2016-05-11T01:17:12Z","body":"This lives in `evancz/elm-graphics` now, but I also would prefer to keep the API like it is. I think you are correct that it could be easier, but I'd like to keep that API stable for now."}}