Antoine Cotten

Another observation is that lines often overflow even with much shorter words. In the example below, the 120 characters limit is right at are documented in the| , but dump() causes that same line to become are documented in the| AWS (where | marks the 120 characters limit). nested: nested: nested: nested: nested: nested: nested: region: - description: Code of the AWS region to source metrics from. Available region codes are documented in the - AWS General Reference at https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints....

The first option is a good workaround. It doesn't scale for me because I'm dealing with > 70 files, and a large number of documentation strings similar to the one in my example. But it's definitely something worth considering. In fact, now that you mention it, I'm using description: | in a few places and these aren't reformatted either. The transform function sounds interesting. I just asked a new question on StackOverflow as you suggested. Thanks!

Unbreakable words are not wrapped