Update advanced usage docs

[styfle]

Description

This adds a couple missing option types to the docs and also shows the version introduced for headerIds.

• Related the option : headerIds is not valid. #1208

Contributor

• no tests required for this PR.

Committer

In most cases, this should be a different person than the contributor.

• Draft GitHub release notes have been updated.
• CI is green (no forced merge required).
• Merge PR

[styfle]

@joshbruce @UziTech @davisjam I'm thinking of adding 2 additional columns to the options table:

• default value
• since version

Do you think that's a good idea?

[joshbruce]

tl;dr: Not a fall of the sword for me. Just some things to consider.

I definitely think having default following type would be good. My only reservation on since would be in keeping up if they're out of sync. Though it does open the door for a deprecated column as well when we get there.

[joshbruce]

If we add the columns, think the order would be:

|Member |Type |Default |Added in |Notes |

[styfle]

Thanks! I went with Since and put v0.4.0 so its clear that its clear that this is a version number. I couldn't easily find when these other features were introduced so I used ???

[styfle]

My only reservation on since would be in keeping up if they're out of sync

I don't understand this reservation. What would get out of sync?

Though it does open the door for a deprecated column as well when we get there.

I like the idea of deprecating too if we ever reach that point.

[UziTech]

LGTM

[styfle]

@joshbruce Any opposition here?