{"action":"opened","issue":{"url":"https://api.github.com/repos/kvasir-io/Kvasir/issues/68","repository_url":"https://api.github.com/repos/kvasir-io/Kvasir","labels_url":"https://api.github.com/repos/kvasir-io/Kvasir/issues/68/labels{/name}","comments_url":"https://api.github.com/repos/kvasir-io/Kvasir/issues/68/comments","events_url":"https://api.github.com/repos/kvasir-io/Kvasir/issues/68/events","html_url":"https://github.com/kvasir-io/Kvasir/issues/68","id":142607896,"number":68,"title":"Usb documentation needed","user":{"login":"porkybrain","id":10760132,"avatar_url":"https://avatars.githubusercontent.com/u/10760132?v=3","gravatar_id":"","url":"https://api.github.com/users/porkybrain","html_url":"https://github.com/porkybrain","followers_url":"https://api.github.com/users/porkybrain/followers","following_url":"https://api.github.com/users/porkybrain/following{/other_user}","gists_url":"https://api.github.com/users/porkybrain/gists{/gist_id}","starred_url":"https://api.github.com/users/porkybrain/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/porkybrain/subscriptions","organizations_url":"https://api.github.com/users/porkybrain/orgs","repos_url":"https://api.github.com/users/porkybrain/repos","events_url":"https://api.github.com/users/porkybrain/events{/privacy}","received_events_url":"https://api.github.com/users/porkybrain/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2016-03-22T10:30:53Z","updated_at":"2016-03-22T10:30:53Z","closed_at":null,"body":"Design goals for the USB abstraction were \r\n- complete static binding  \r\n- fully configurable (to the point of micromanaging memory strategy) \r\n- unit tested for everything upwards from the HAL \r\nAlthough I think these can be/have been met the interfaces between the HAL and the USB::Device as well as the interface between the USB::Device and the device classes could not be implemented as cleanly as I had hoped. \r\nWe need to do a good job of documenting the contracts between the Usb::Device and the Hal as well as the contracts between the Usb::Device and the interface class(es).\r\n"}}