Akka-http: Consolidate java/scala content in akka-http

[richardimaoka]

Like we are doing on akka/akka#23052 "consolidate java/scala content", let's consolidate the java and scala contents in akka-http, too.

Below is the procedure described by @raboof.

The process is as follows:

• Mention in this issue which pages you're planning to merge
  
  
  
  • Either the Akka maintainers or @richard-imaoka can update the list below
  
  
• Compare a file in docs/src/main/paradox/java/... with the same one under docs/src/main/paradox/scala/.... They should cover the same contents, but one is for Java and the other is for Scala. The 'compare files' feature of IntelliJ IDEA is a nice tool for this.
• Update the file in the scala folder to contain both the Scala and Java content. You may use:
  @scala and @java directives for inline text
  @@@ div { .group-scala } for blocks
  code blocks become tabbed
• Replace the 'java' version of the page with a symlink:
  
  
  
  • Remove the old version (git rm akka-docs/src/main/paradox/java/...)
  
  
  • Create a symlink (cd akka-docs/src/main/paradox/java; ln -s ../scala/... ...; cd -)
  
  
  • Add the symlink to git (git add akka-docs/src/main/paradox/java/...)
    
    Test your changes (sbt akka-docs/paradox, see CONTRIBUTING.md for details, check both the Java and Scala versions)
  
  

You could look at https://github.com/akka/akka/pull/23039/files as an example - it's probably best to contribute PR's on a page-per-page basis at least at first. Feel free to let us know if you have any questions/problems!

[richardimaoka]

Let me know which one you want to work on, and I'll mark your name for the file!

Under docs/src/main/paradox/java/http/

• [x] client-side/client-https-support.md - @jonas
• [x] client-side/client-transport.md - @jonas
• [x] client-side/connection-level.md - @jonas
• [x] client-side/host-level.md (@jlprat)
• [x] client-side/index.md (@jlprat)
• [x] client-side/pool-overflow.md (@jlprat)
• [x] client-side/request-level.md (@jlprat)
• [x] client-side/websocket-support.md (@jlprat)
• [x] common/de-coding.md (@jlprat)
• [x] common/http-model.md (@jlprat)
• [x] common/index.md - @jonas
• [x] common/json-support.md (@jonas)
• [x] common/marshalling.md - (@jonas, #1367)
• [x] common/timeouts.md - @jonas
• [x] common/unmarshalling.md - @jonas
• [x] common/uri-model.md (@jlprat)
• [x] configuration.md (@jlprat)
• [x] handling-blocking-operations-in-akka-http-routes.md (@jlprat)
• [x] implications-of-streaming-http-entity.md (@jlprat)
• [x] index.md (@jlprat)
• [x] introduction.md (@jlprat)
• [x] migration-guide/index.md (@jrudolph)
• [x] migration-guide/migration-from-old-http-javadsl.md (@jrudolph)
• [x] migration-guide/migration-guide-2.4.x-10.0.x.md (@jrudolph)
• [x] routing-dsl/exception-handling.md (@jlprat)
• [x] routing-dsl/HttpApp.md (@jlprat)
• [x] routing-dsl/index.md (@raboof #1600)
• [x] routing-dsl/marshalling.md - should be merged into common/marshalling - (@jonas, #1367)
• [x] routing-dsl/overview.md (@raboof, #1599)
• [x] routing-dsl/rejections.md (@jonas)
• [x] routing-dsl/routes.md (@atiqsayyed)
• [x] routing-dsl/source-streaming-support.md (@atiqsayyed)
• [x] routing-dsl/testkit.md (@atiqsayyed)
• [x] sse-support.md (@jonas)
• [x] server-side/low-level-server-side-api.md (@jlprat)
• [x] server-side/websocket-support.md (@jonas)
• [x] server-side-https-support.md (@jonas)

and

• [ ] docs/src/main/paradox/java.md
  

Directives:

• [x] routing-dsl/directives/cookie-directives/setCookie.md
• [x] routing-dsl/directives/cookie-directives/deleteCookie.md
• [x] routing-dsl/directives/cookie-directives/cookie.md
• [x] routing-dsl/directives/cookie-directives/optionalCookie.md
• [x] routing-dsl/directives/scheme-directives/extractScheme.md
• [x] routing-dsl/directives/scheme-directives/scheme.md
• [x] routing-dsl/directives/cache-condition-directives/conditional.md
• [x] routing-dsl/directives/caching-directives/alwaysCache.md
• [x] routing-dsl/directives/caching-directives/cachingProhibited.md
• [x] routing-dsl/directives/header-directives/headerValuePF.md
• [x] routing-dsl/directives/websocket-directives/handleWebSocketMessages.md
• [x] routing-dsl/directives/websocket-directives/handleWebSocketMessagesForProtocol.md
• [x] routing-dsl/directives/path-directives/redirectToNoTrailingSlashIfPresent.md
• [x] routing-dsl/directives/path-directives/redirectToTrailingSlashIfMissing.md
• [x] routing-dsl/directives/path-directives/pathSuffixTest.md
• [x] routing-dsl/directives/path-directives/ignoreTrailingSlash.md
• [x] routing-dsl/directives/misc-directives/requestEntityPresent.md
• [x] routing-dsl/directives/misc-directives/requestEntityEmpty.md
• [x] routing-dsl/directives/misc-directives/selectPreferredLanguage.md
• [x] routing-dsl/directives/misc-directives/withoutSizeLimit.md
• [x] routing-dsl/directives/file-upload-directives/uploadedFile.md
• [x] routing-dsl/directives/route-directives/reject.md
• [x] routing-dsl/directives/route-directives/failWith.md
• [x] routing-dsl/directives/file-and-resource-directives/getFromBrowseableDirectories.md
• [x] routing-dsl/directives/file-and-resource-directives/getFromDirectory.md
• [x] routing-dsl/directives/file-and-resource-directives/getFromFile.md
• [x] routing-dsl/directives/coding-directives/withPrecompressedMediaTypeSupport.md
• [x] routing-dsl/directives/coding-directives/encodeResponse.md
• [x] routing-dsl/directives/coding-directives/decodeRequest.md
• [x] routing-dsl/directives/coding-directives/decodeRequestWith.md
• [x] routing-dsl/directives/coding-directives/encodeResponseWith.md
• [x] routing-dsl/directives/coding-directives/responseEncodingAccepted.md
• [x] routing-dsl/directives/timeout-directives/withRequestTimeoutResponse.md
• [x] routing-dsl/directives/timeout-directives/withoutRequestTimeout.md
• [x] routing-dsl/directives/execution-directives/handleRejections.md
• [x] routing-dsl/directives/execution-directives/handleExceptions.md
• [x] routing-dsl/directives/respond-with-directives/respondWithHeaders.md
• [x] routing-dsl/directives/respond-with-directives/respondWithDefaultHeader.md
• [x] routing-dsl/directives/respond-with-directives/respondWithHeader.md
• [x] routing-dsl/directives/basic-directives/extractMatchedPath.md
• [x] routing-dsl/directives/basic-directives/extractMaterializer.md
• [x] routing-dsl/directives/basic-directives/extractUri.md
• [x] routing-dsl/directives/basic-directives/extractActorSystem.md
• [x] routing-dsl/directives/basic-directives/extractSettings.md
• [x] routing-dsl/directives/basic-directives/mapUnmatchedPath.md
• [x] routing-dsl/directives/basic-directives/extractStrictEntity.md
• [x] routing-dsl/directives/basic-directives/extractRequestEntity.md
• [x] routing-dsl/directives/basic-directives/extractExecutionContext.md
• [x] routing-dsl/directives/basic-directives/extractRequestContext.md
• [x] routing-dsl/directives/basic-directives/cancelRejection.md
• [x] routing-dsl/directives/basic-directives/cancelRejections.md
• [x] routing-dsl/directives/basic-directives/withMaterializer.md
• [x] routing-dsl/directives/basic-directives/withSettings.md
• [x] routing-dsl/directives/basic-directives/pass.md
• [x] routing-dsl/directives/basic-directives/mapInnerRoute.md
• [x] routing-dsl/directives/basic-directives/toStrictEntity.md
• [x] routing-dsl/directives/basic-directives/withLog.md
• [ ] routing-dsl/directives/cookie-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/scheme-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/cache-condition-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/caching-directives/cache.md (@raboof, first #1579)
• [ ] routing-dsl/directives/caching-directives/index.md
• [ ] routing-dsl/directives/form-field-directives/formFieldList.md
• [ ] routing-dsl/directives/form-field-directives/formField.md
• [ ] routing-dsl/directives/form-field-directives/formFieldMultiMap.md
• [ ] routing-dsl/directives/form-field-directives/formFieldMap.md
• [ ] routing-dsl/directives/form-field-directives/index.md
• [ ] routing-dsl/directives/host-directives/extractHostName.md
• [ ] routing-dsl/directives/host-directives/host.md
• [ ] routing-dsl/directives/host-directives/index.md
• [ ] routing-dsl/directives/header-directives/optionalHeaderValue.md
• [ ] routing-dsl/directives/header-directives/optionalHeaderValuePF.md
• [ ] routing-dsl/directives/header-directives/headerValue.md
• [ ] routing-dsl/directives/header-directives/optionalHeaderValueByType.md
• [ ] routing-dsl/directives/header-directives/checkSameOrigin.md
• [ ] routing-dsl/directives/header-directives/headerValueByType.md
• [ ] routing-dsl/directives/header-directives/headerValueByName.md
• [ ] routing-dsl/directives/header-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/header-directives/optionalHeaderValueByName.md
• [ ] routing-dsl/directives/websocket-directives/extractOfferedWsProtocols.md
• [ ] routing-dsl/directives/websocket-directives/extractUpgradeToWebSocket.md
• [ ] routing-dsl/directives/websocket-directives/handleWebSocketMessagesForOptionalProtocol.md
• [ ] routing-dsl/directives/websocket-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/parameter-directives/parameters.md
• [ ] routing-dsl/directives/parameter-directives/parameterMap.md
• [ ] routing-dsl/directives/parameter-directives/parameterMultiMap.md
• [ ] routing-dsl/directives/parameter-directives/parameter.md
• [ ] routing-dsl/directives/parameter-directives/parameterSeq.md
• [ ] routing-dsl/directives/parameter-directives/index.md
• [ ] routing-dsl/directives/debugging-directives/logResult.md
• [ ] routing-dsl/directives/debugging-directives/logRequest.md
• [ ] routing-dsl/directives/debugging-directives/logRequestResult.md
• [ ] routing-dsl/directives/debugging-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/path-directives/rawPathPrefixTest.md
• [ ] routing-dsl/directives/path-directives/pathPrefixTest.md
• [ ] routing-dsl/directives/path-directives/pathSuffix.md
• [ ] routing-dsl/directives/path-directives/pathEndOrSingleSlash.md
• [ ] routing-dsl/directives/path-directives/rawPathPrefix.md
• [ ] routing-dsl/directives/path-directives/pathSingleSlash.md
• [ ] routing-dsl/directives/path-directives/pathEnd.md
• [ ] routing-dsl/directives/path-directives/index.md
• [ ] routing-dsl/directives/path-directives/pathPrefix.md
• [ ] routing-dsl/directives/path-directives/path.md
• [ ] routing-dsl/directives/method-directives/options.md
• [ ] routing-dsl/directives/method-directives/overrideMethodWithParameter.md
• [ ] routing-dsl/directives/method-directives/post.md
• [ ] routing-dsl/directives/method-directives/delete.md
• [ ] routing-dsl/directives/method-directives/extractMethod.md
• [ ] routing-dsl/directives/method-directives/head.md
• [ ] routing-dsl/directives/method-directives/get.md
• [ ] routing-dsl/directives/method-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/method-directives/method.md
• [ ] routing-dsl/directives/method-directives/put.md
• [ ] routing-dsl/directives/method-directives/patch.md
• [ ] routing-dsl/directives/misc-directives/withSizeLimit.md
• [ ] routing-dsl/directives/misc-directives/extractClientIP.md
• [ ] routing-dsl/directives/misc-directives/rejectEmptyResponse.md
• [ ] routing-dsl/directives/misc-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/misc-directives/validate.md
• [ ] routing-dsl/directives/file-upload-directives/storeUploadedFiles.md
• [ ] routing-dsl/directives/file-upload-directives/fileUploadAll.md
• [ ] routing-dsl/directives/file-upload-directives/fileUpload.md
• [ ] routing-dsl/directives/file-upload-directives/storeUploadedFile.md
• [ ] routing-dsl/directives/file-upload-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/range-directives/withRangeSupport.md
• [ ] routing-dsl/directives/range-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/future-directives/completeOrRecoverWith.md
• [ ] routing-dsl/directives/future-directives/onCompleteWithBreaker.md
• [ ] routing-dsl/directives/future-directives/onSuccess.md
• [ ] routing-dsl/directives/future-directives/onComplete.md
• [ ] routing-dsl/directives/future-directives/index.md
• [ ] routing-dsl/directives/custom-directives.md
• [ ] routing-dsl/directives/security-directives/authorizeAsync.md
• [ ] routing-dsl/directives/security-directives/authenticateOAuth2PF.md
• [ ] routing-dsl/directives/security-directives/authorize.md
• [ ] routing-dsl/directives/security-directives/authenticateBasicPFAsync.md
• [ ] routing-dsl/directives/security-directives/authenticateOrRejectWithChallenge.md
• [ ] routing-dsl/directives/security-directives/authenticateBasic.md
• [ ] routing-dsl/directives/security-directives/authenticateBasicAsync.md
• [ ] routing-dsl/directives/security-directives/authenticateOAuth2Async.md
• [ ] routing-dsl/directives/security-directives/authenticateOAuth2PFAsync.md
• [ ] routing-dsl/directives/security-directives/index.md
• [ ] routing-dsl/directives/security-directives/authenticateBasicPF.md
• [ ] routing-dsl/directives/security-directives/authenticateOAuth2.md
• [ ] routing-dsl/directives/security-directives/extractCredentials.md
• [ ] routing-dsl/directives/alphabetically.md
• [ ] routing-dsl/directives/route-directives/redirect.md
• [ ] routing-dsl/directives/route-directives/complete.md
• [ ] routing-dsl/directives/route-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/file-and-resource-directives/getFromResourceDirectory.md
• [ ] routing-dsl/directives/file-and-resource-directives/listDirectoryContents.md
• [ ] routing-dsl/directives/file-and-resource-directives/getFromBrowseableDirectory.md
• [ ] routing-dsl/directives/file-and-resource-directives/getFromResource.md
• [ ] routing-dsl/directives/file-and-resource-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/by-trait.md
• [ ] routing-dsl/directives/path-directives.md
• [ ] routing-dsl/directives/coding-directives/requestEncodedWith.md
• [ ] routing-dsl/directives/coding-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/timeout-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/timeout-directives/withRequestTimeout.md
• [ ] routing-dsl/directives/marshalling-directives/completeWith.md
• [ ] routing-dsl/directives/marshalling-directives/entity.md
• [ ] routing-dsl/directives/marshalling-directives/handleWith.md
• [ ] routing-dsl/directives/marshalling-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/execution-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/index.md
• [ ] routing-dsl/directives/respond-with-directives/respondWithDefaultHeaders.md
• [ ] routing-dsl/directives/respond-with-directives/index.md (@raboof #1608)
• [ ] routing-dsl/directives/basic-directives/mapRequestContext.md
• [ ] routing-dsl/directives/basic-directives/provide.md
• [ ] routing-dsl/directives/basic-directives/recoverRejections.md
• [ ] routing-dsl/directives/basic-directives/mapRejections.md
• [ ] routing-dsl/directives/basic-directives/mapRequest.md
• [ ] routing-dsl/directives/basic-directives/recoverRejectionsWith.md
• [ ] routing-dsl/directives/basic-directives/mapSettings.md
• [ ] routing-dsl/directives/basic-directives/mapResponseEntity.md
• [ ] routing-dsl/directives/basic-directives/mapRouteResultPF.md
• [ ] routing-dsl/directives/basic-directives/extractUnmatchedPath.md
• [ ] routing-dsl/directives/basic-directives/extract.md
• [ ] routing-dsl/directives/basic-directives/mapRouteResult.md
• [ ] routing-dsl/directives/basic-directives/extractRequest.md
• [ ] routing-dsl/directives/basic-directives/extractDataBytes.md
• [ ] routing-dsl/directives/basic-directives/extractLog.md
• [ ] routing-dsl/directives/basic-directives/mapResponseHeaders.md
• [ ] routing-dsl/directives/basic-directives/mapRouteResultFuture.md
• [ ] routing-dsl/directives/basic-directives/mapResponse.md
• [ ] routing-dsl/directives/basic-directives/mapRouteResultWith.md
• [ ] routing-dsl/directives/basic-directives/withExecutionContext.md
• [ ] routing-dsl/directives/basic-directives/index.md
• [ ] routing-dsl/directives/basic-directives/mapRouteResultWithPF.md
• [ ] routing-dsl/directives/basic-directives/extractParserSettings.md

[jrudolph]

Thanks a lot @richard-imaoka for getting this initiative started. I think we might want to exclude the directives details pages for now. One reason is that they don't all map 1-to-1 and the other is that the other documentation is currently more important to be merged.

[richardimaoka]

OK sure, removed the directives details pages.

[jrudolph]

:+1:, thanks. Let's start with the other ones.

[jlprat]

What if a whole section should be on the Scala version but not on the Java one (or vice-versa)? What's the way to do it?

[raboof]

@jlprat Unfortunately we don't have a way to make ToC elements conditional yet, see https://github.com/lightbend/paradox/issues/128

[jlprat]

OK, from the top of my head, there are a couple of pages where some sections are missing on Java (custom headers for example)

[jrudolph]

Yes, there will probably some difficulties but that shouldn't stop us from starting the work on the easier cases.

[jlprat]

Indeed! I will take one of them later today

On Thu, Jul 20, 2017, 15:33 Johannes Rudolph [e-mail]
wrote:

Yes, there will probably some difficulties but that shouldn't stop us from
starting the work on the easier cases.

—
You are receiving this because you were mentioned.

Reply to this email directly, view it on GitHub
https://github.com/akka/akka-http/issues/1290#issuecomment-316704354,
or mute the thread
https://github.com/notifications/unsubscribe-auth/ADLuC-tkW7ybqPJF-jGzs_L7tdG4gsOKks5sP1dDgaJpZM4OcKB5
.

[jlprat]

I take HttpApp

[jonas]

Did

• client-side/client-https-support.md
• client-side/client-transport.md
• client-side/connection-level.md
• common/timeouts.md

[jonas]

I wrote a small script to help track status and to do the initial work of merging a page:

> scripts/doc-merge.sh status
client-side/client-https-support.md                          : Merged
client-side/client-transport.md                              : Merged
client-side/connection-level.md                              : Merged
client-side/host-level.md                                    : Merged
client-side/index.md                                         : Merged
client-side/pool-overflow.md                                 : Merged
client-side/request-level.md                                 : Merged
client-side/websocket-support.md                             : Merged
common/encoding.md                                           : Merged
common/http-model.md                                         : Merged
common/index.md                                              : Merged
common/json-support.md                                       : Merged
common/marshalling.md                                        : 14 insertions(+), 18 deletions(-)
common/timeouts.md                                           : Merged
common/unmarshalling.md                                      : 6 insertions(+), 12 deletions(-)
common/uri-model.md                                          : Merged
common/xml-support.md                                        : Merged
compatibility-guidelines.md                                  : Merged
configuration.md                                             : Merged
handling-blocking-operations-in-akka-http-routes.md          : Merged
implications-of-streaming-http-entity.md                     : Merged
index.md                                                     : Merged
introduction.md                                              : Merged
migration-guide/index.md                                     : Merged
migration-guide/migration-from-old-http-javadsl.md           : Merged
migration-guide/migration-from-spray.md                      : Merged
migration-guide/migration-guide-10.0.x.md                    : Merged
migration-guide/migration-guide-2.4.x-10.0.x.md              : Merged
release-notes.md                                             : Merged
routing-dsl/HttpApp.md                                       : Merged
routing-dsl/case-class-extraction.md                         : No java version
routing-dsl/exception-handling.md                            : Merged
routing-dsl/index.md                                         : 29 insertions(+), 10 deletions(-)
routing-dsl/marshalling.md                                   : No scala version
routing-dsl/overview.md                                      : 28 insertions(+), 17 deletions(-)
routing-dsl/path-matchers.md                                 : No java version
routing-dsl/rejections.md                                    : Merged
routing-dsl/routes.md                                        : 62 insertions(+), 53 deletions(-)
routing-dsl/source-streaming-support.md                      : 80 insertions(+), 35 deletions(-)
routing-dsl/testkit.md                                       : 104 insertions(+), 72 deletions(-)
security.md                                                  : Merged
security/2016-09-30-windows-directory-traversal.md           : Merged
security/2017-01-23-denial-of-service-via-leak-on-unconsumed-closed-connections.md : Merged
security/2017-05-03-illegal-media-range-in-accept-header-causes-stackoverflowerror.md : Merged
server-side/http2.md                                         : Merged
server-side/low-level-api.md                                 : Merged
server-side/server-https-support.md                          : Merged
server-side/websocket-support.md                             : Merged
sse-support.md                                               : Merged

doc-merge.sh.txt

[jlprat]

The 2 last ones (server-side/...) have the Scala equivalent 1 level up.

[jonas]

@jlprat Is the plan to move the Scala pages into the server-side directory?

[jlprat]

I have no strong opinion about it, but I'd say better move the Java ones 1 level up, as the folder server-side makes not much sense with only those 2 files

[jlprat]

For the page Implications of the Streaming Nature... I need https://github.com/akka/akka-http/pull/1322 to be merged as it references server-side/low-level-server-side-api.md

[ktoso]

Marked request level client as done by @jlprat

[jonas]

Added sse-support.md with pending PR in #1349

[jlprat]

BTW, what's the plan for the Java docs for common Marshalling and Unmarshalling. They have a big nice TODO on the header. Shall we merge, and then do the overhaul?
http://doc.akka.io/docs/akka-http/current/java/http/common/marshalling.html
http://doc.akka.io/docs/akka-http/current/java/http/common/unmarshalling.html

Edit: Regarding this, https://github.com/akka/akka-http/issues/1367

[atiqsayyed]

Can I pick these??

• routing-dsl/routes.md
• routing-dsl/source-streaming-support.md
• routing-dsl/testkit.md

[jlprat]

Sure!
Thanks @atiqsayyed

[jonas]

Will take the remaining pages in common.

[jlprat]

Do we have any way to have a java/scala-dependent TOC entry?

[raboof]

I'm afraid we ended up not needing that yet for the Akka docs so that's still an open issue (https://github.com/lightbend/paradox/issues/128).

[jlprat]

We need that for http://doc.akka.io/docs/akka-http/current/java/http/routing-dsl/index.html vs http://doc.akka.io/docs/akka-http/current/scala/http/routing-dsl/index.html
"Case Class Extraction" only exists on Scala. Any suggestion?

[jonas]

Yay, we are down to ~9 pages remaining.

@atiqsayyed How is going with merging the Routing DSL pages?

[atiqsayyed]

@jonas should be done by tomorrow :)

[ktoso]

Thanks @atiqsayyed for handling source-streaming-support.md! Just a few left :)

[raboof]

@jlprat I think I found a nice solution for java/scala-specific ToC entries, https://github.com/akka/akka-http/pull/1600

[jlprat]

Cool! I will take a look!

On Wed, Dec 6, 2017, 15:17 Arnout Engelen [e-mail] wrote:

@jlprat https://github.com/jlprat I think I found a nice solution for
java/scala-specific ToC entries, #1600
https://github.com/akka/akka-http/pull/1600

—
You are receiving this because you were mentioned.

Reply to this email directly, view it on GitHub
https://github.com/akka/akka-http/issues/1290#issuecomment-349652321,
or mute the thread
https://github.com/notifications/unsubscribe-auth/ADLuC-Zwoi3Y5yOCixblZQwucSaPIkRcks5s9qIPgaJpZM4OcKB5
.

[raboof]

Just about there for the 'regular' documentation, seems like it's time to start tackling the directives now. I've already scripted some common differences in #1608, but there's plenty left - I've added them to the list above.

[jonas]

@raboof I suggest to close this ticket and track consolidation of the routing DSL docs in a new ticket since the history is getting quite long.

[raboof]

@jonas works for me! @richardimaoka you want to help keep inventory of progress again?

[raboof]

@richardimaoka did you see the ping above? :)

[richardimaoka]

Sorry I misses the earlier message. I didn’t fully go thorough the conversation in detail but it’s about closing this issue and open a new one? Fine for me then.

[raboof]

@richardimaoka Indeed! Do you want to create the ticket again?

[richardimaoka]

What's the most recent status? Is it tracked in https://github.com/akka/akka-http/issues/1290#issuecomment-316255843, or should I run @jonas's script to check the status?

[raboof]

I think that comment should be accurate - I haven't run the script myself

[richardimaoka]

OK, here you go ! #1624