Code Annotations: How to set up a Custom Selector for HTTP?

[Valerie-ts]

hi all,

I'm using code annotations in my documentation (love it, has been working great so far), but now I have an http code block, where comments are not supported. I managed to add a custom selector for the json request body within my http block, but I'd also like to add an annotation to Content-Length and I'm stuck on how to set this up. Does anyone have any tips or solutions for me?

This is my .yml file:

extra:
  annotate:
    json: [.s2]
    http: [.s2]

This is my http code block:

POST /v0/connections/sap/{name} HTTP/1.1
Host: localhost:1337
Content-Type: application/json
Content-Length: 142
{
"Host": "sap-erp-as05.example.com",
"User": "alice",
"Password": "myPassword",
"Client": "800",
"Language": "en",
"InstanceNo": 0
}

[mocdaniel]

As per the Code Blocks > Adding Annotations docs, it's currently not possible to add annotations to code blocks if their language doesn't have comments:

Code annotations require syntax highlighting with Pygments – they're currently not compatible with JavaScript syntax highlighters, or languages that do not have comments in their grammar. However, we're actively working on supporting alternate ways of defining code annotations, allowing to always place code annotations at the end of lines.