provide examples that include all optional attributes

[kdenhartog]

Right now there's attributes that are defined without any examples. This can lead to confusion around what the purpose of these attributes should be used for. We should add examples to this that show how these fields are used, and potentially add additional explanations if needed.