The specification reference is difficult to read

[johnbellessa]

Apologies if this isn't the place to bring it up, and it might just be me, but I've found the specification reference almost unusable because extremely detailed and important descriptions are crammed into very narrow columns.

Just a couple examples:

I'm always surprised when I never find anything about this in the issues or discussions, so maybe it's just me, but I find it very difficult to parse the information or locate specific details within the descriptions.

[robscott]

Completely agree that this is an issue. Unfortunately it will require someone to update https://github.com/elastic/crd-ref-docs or explore using another solution entirely.

[johnbellessa]

@robscott thanks for the quick follow-up. I understand, it's certainly not a trivial thing to change given how the docs are structured. I just wanted to raise the issue so there's at least some discussion on it.

[youngnick]

Yes, thanks for logging this one to remind us @johnbellessa. Please feel free to bump it if we don't get to it. 😄