Document comments in Painless

[ycombinator]

Painless apparently supports // ... and /* ... */ style comments. This is useful when writing out long, complex scripts.

It would be great to have this feature documented in https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting-painless.html and/or https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting-painless-syntax.html.

Thanks!

[nik9000]

@jdconrad is this a thing you are covering in your docs work? Should I assign this to you so you can close that when it is in?

[jdconrad]

@nik9000 I assigned to myself as this will be included in my updated documentation.

[nik9000]

@nik9000 I assigned to myself as this will be included in my updated documentation.

Thanks!

[drawsmcgraw]

Hi @jdconrad! I've submitted #24550 to help take this off your list. Hopefully I inferred the documentation style correctly. I'm happy to make any requested changes.

[jdconrad]

This is in the existing documentation now. https://www.elastic.co/guide/en/elasticsearch/painless/current/painless-specification.html