{"action":"created","issue":{"url":"https://api.github.com/repos/akka/akka/issues/18496","labels_url":"https://api.github.com/repos/akka/akka/issues/18496/labels{/name}","comments_url":"https://api.github.com/repos/akka/akka/issues/18496/comments","events_url":"https://api.github.com/repos/akka/akka/issues/18496/events","html_url":"https://github.com/akka/akka/issues/18496","id":106878304,"number":18496,"title":"Missing Http Directive Docs","user":{"login":"ktoso","id":120979,"avatar_url":"https://avatars.githubusercontent.com/u/120979?v=3","gravatar_id":"","url":"https://api.github.com/users/ktoso","html_url":"https://github.com/ktoso","followers_url":"https://api.github.com/users/ktoso/followers","following_url":"https://api.github.com/users/ktoso/following{/other_user}","gists_url":"https://api.github.com/users/ktoso/gists{/gist_id}","starred_url":"https://api.github.com/users/ktoso/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ktoso/subscriptions","organizations_url":"https://api.github.com/users/ktoso/orgs","repos_url":"https://api.github.com/users/ktoso/repos","events_url":"https://api.github.com/users/ktoso/events{/privacy}","received_events_url":"https://api.github.com/users/ktoso/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/akka/akka/labels/3%20-%20in%20progress","name":"3 - in progress","color":"eb6420"},{"url":"https://api.github.com/repos/akka/akka/labels/t:docs","name":"t:docs","color":"CCCCCC"},{"url":"https://api.github.com/repos/akka/akka/labels/t:http","name":"t:http","color":"CCCCCC"},{"url":"https://api.github.com/repos/akka/akka/labels/t:http:server:dsl","name":"t:http:server:dsl","color":"ededed"}],"state":"open","locked":false,"assignee":{"login":"ktoso","id":120979,"avatar_url":"https://avatars.githubusercontent.com/u/120979?v=3","gravatar_id":"","url":"https://api.github.com/users/ktoso","html_url":"https://github.com/ktoso","followers_url":"https://api.github.com/users/ktoso/followers","following_url":"https://api.github.com/users/ktoso/following{/other_user}","gists_url":"https://api.github.com/users/ktoso/gists{/gist_id}","starred_url":"https://api.github.com/users/ktoso/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ktoso/subscriptions","organizations_url":"https://api.github.com/users/ktoso/orgs","repos_url":"https://api.github.com/users/ktoso/repos","events_url":"https://api.github.com/users/ktoso/events{/privacy}","received_events_url":"https://api.github.com/users/ktoso/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/akka/akka/milestones/54","html_url":"https://github.com/akka/akka/milestones/http-1.1","labels_url":"https://api.github.com/repos/akka/akka/milestones/54/labels","id":1208890,"number":54,"title":"http-1.1","description":"","creator":{"login":"ktoso","id":120979,"avatar_url":"https://avatars.githubusercontent.com/u/120979?v=3","gravatar_id":"","url":"https://api.github.com/users/ktoso","html_url":"https://github.com/ktoso","followers_url":"https://api.github.com/users/ktoso/followers","following_url":"https://api.github.com/users/ktoso/following{/other_user}","gists_url":"https://api.github.com/users/ktoso/gists{/gist_id}","starred_url":"https://api.github.com/users/ktoso/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ktoso/subscriptions","organizations_url":"https://api.github.com/users/ktoso/orgs","repos_url":"https://api.github.com/users/ktoso/repos","events_url":"https://api.github.com/users/ktoso/events{/privacy}","received_events_url":"https://api.github.com/users/ktoso/received_events","type":"User","site_admin":false},"open_issues":47,"closed_issues":32,"state":"open","created_at":"2015-07-15T09:32:18Z","updated_at":"2015-09-29T18:43:35Z","due_on":null,"closed_at":null},"comments":2,"created_at":"2015-09-16T22:43:11Z","updated_at":"2015-09-29T20:14:28Z","closed_at":null,"body":"Accumulated list of remaining Directive documentation work by skimming the alphabetical list one by one:\r\n\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/security-directives/authenticateBasic.html#authenticatebasic missing docs and example, referred test file is commented out\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/security-directives/authenticateBasicAsync.html#authenticatebasicasync missing docs and example, referred test file is commented out\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/security-directives/authenticateBasicPF.html#authenticatebasicpf missing docs and example, referred test file is commented out\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/security-directives/authenticateBasicPFAsync.html#authenticatebasicpfasync\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/security-directives/authenticateOrRejectWithChallenge.html#authenticateorrejectwithchallenge missing docs and example, referred test file is commented out\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/respond-with-directives/overrideStatusCode.html#overridestatuscode missing example, example missing from test, test is commented out\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/parameter-directives/parameter.html#parameter fix includecode, sample is present OK\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/parameter-directives/parameterMap.html#parametermap fix includecode, sample is present\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/parameter-directives/parameterMultiMap.html#parametermultimap fix include code, sample is present\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/recoverRejections.html#recoverrejections missing desc, missing snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/recoverRejectionsWith.html#recoverrejectionswith missing desc, missing snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/path-directives/redirectToNoTrailingSlashIfPresent.html#redirecttonotrailingslashifpresent missing desc, snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/path-directives/redirectToTrailingSlashIfMissing.html#redirecttotrailingslashifmissing missing desc, snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/coding-directives/requestEncodedWith.html#requestencodedwith missing example (maybe not needed, instead add links?)\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/respond-with-directives/respondWithDefaultHeader.html#respondwithdefaultheader missing snippet, referrenced test file is commented out (RespondWithDirectivesExamplesSpec.scala)\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/respond-with-directives/respondWithHeader.html#respondwithheader referrenced test file commented out, test exists for it inside\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/respond-with-directives/respondWithHeaders.html#respondwithheaders  referrenced test file commented out, test exists for it inside\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/coding-directives/responseEncodingAccepted.html#responseencodingaccepted needs example\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/misc-directives/validate.html#validate missing description (maybe ok)\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/withExecutionContext.html#withexecutioncontext missing snippet and desc\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/withMaterializer.html#withmaterializer missing snippet and desc\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/withLog.html#withlog missing snippet and desc\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/withSettings.html#withsettings missing snippet and desc\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/method-directives/overrideMethodWithParameter.html#overridemethodwithparameter missing snippet and desc\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/header-directives/optionalHeaderValuePF.html#optionalheadervaluepf missing snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/header-directives/optionalHeaderValueByName.html#optionalheadervaluebyname missing snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/header-directives/optionalHeaderValue.html#optionalheadervalue missing snippet \r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/mapSettings.html#mapsettings missign desc and snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/mapRouteResultWithPF.html#maprouteresultwithpf missing desc and snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/mapRouteResultWith.html#maprouteresultwith missing doc and snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/mapRouteResultFuture.html#maprouteresultfuture missing doc and snippet\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/file-and-resource-directives/listDirectoryContents.html#listdirectorycontents example would be nice (very simple)\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/websocket-directives/handleWebsocketMessages.html#handlewebsocketmessages needs example and desc!\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/file-and-resource-directives/getFromBrowseableDirectory.html#getfrombrowseabledirectory and friends, maybe show example output?\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/form-field-directives/formField.html#formfield just an alias but example would be nice\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/extractSettings.html#extractsettings docs and example\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/extractRequestContext.html#extractrequestcontext missing docs and example\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/method-directives/extractMethod.html#extractmethod missing desc and example\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/extractLog.html#extractlog missing desc and example\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/extractMaterializer.html#extractmaterializer missing desc and example \r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/security-directives/extractCredentials.html#extractcredentials missing desc and examples\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/coding-directives/encodeResponseWith.html#encoderesponsewith missind desc\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/coding-directives/decodeRequestWith.html#decoderequestwith missing desc and example\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/cancelRejections.html#cancelrejections missing desc\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/basic-directives/cancelRejection.html#cancelrejection missing desc\r\n- [ ] http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/scala/http/routing-dsl/directives/security-directives/authorize.html#authorize missing desc and example\r\n\r\nRelated, 2 in here: https://github.com/akka/akka/issues/18097\r\n\r\n// FYI @jrudolph @sirthias "},"comment":{"url":"https://api.github.com/repos/akka/akka/issues/comments/144178870","html_url":"https://github.com/akka/akka/issues/18496#issuecomment-144178870","issue_url":"https://api.github.com/repos/akka/akka/issues/18496","id":144178870,"user":{"login":"ktoso","id":120979,"avatar_url":"https://avatars.githubusercontent.com/u/120979?v=3","gravatar_id":"","url":"https://api.github.com/users/ktoso","html_url":"https://github.com/ktoso","followers_url":"https://api.github.com/users/ktoso/followers","following_url":"https://api.github.com/users/ktoso/following{/other_user}","gists_url":"https://api.github.com/users/ktoso/gists{/gist_id}","starred_url":"https://api.github.com/users/ktoso/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ktoso/subscriptions","organizations_url":"https://api.github.com/users/ktoso/orgs","repos_url":"https://api.github.com/users/ktoso/repos","events_url":"https://api.github.com/users/ktoso/events{/privacy}","received_events_url":"https://api.github.com/users/ktoso/received_events","type":"User","site_admin":false},"created_at":"2015-09-29T20:14:28Z","updated_at":"2015-09-29T20:14:28Z","body":"Also, all except `PathDirectives` are missing from the java documentation: http://doc.akka.io/docs/akka-stream-and-http-experimental/1.0/java/http/routing-dsl/directives/index.html\r\n\r\nMaybe we should figure out some way of lessening the duplication somehow...?"}}