Documentation on UPDATE Community ChangeType is unclear

[anno1985]

I want to run an UPDATE against our database using liquibase.

However, after perusing its docs for UPDATE Community Change Types at Content/change-types/community/update.html (website) I have more questions than answers; here are my observations:

• The column's name property isn't explained (but used in examples).
• There's no hint in the text that an element within columns should be named column. (The XML example directly nests the column element as a direct child element of update; that's not listed as an option in the table.)
• YAML format (that's what I'd like to use) doesn't seem to differentiate between nested properties and attributes - they are on the same level - so how are they different?
• It's unclear what nested property the nested property attributes refer to. I'm guessing they refer to column, but from that page, you could just as well try to apply them to the where property.
• It's unclear to me why there is a where on the attributes and the nested properties level. What's meant by the "name" of the where condition string in the description for the where attribute ("The name of the 'where' condition string")?
• The page on insert includes a link to https://docs.liquibase.com/change-types/community/add-column.html#Informa in the description cell for the columns property that might be helpful on the update page as well.
• There's a typo in the "Uses" section: "another attributes" should probably read "other attributes".

It would be neat if the docs could be clarified. :-)