Add last_affected example for clarity

[hayleycd]

Hopefully wraps up #150 and #146

View rendered example here.

Changes were also made to the affected.ranges.events fields to bring the formatting into line with the rest of the document. Fields were being rendered like this: "last_affected" where last_affected is preferred.

[andrewpollock]

LGTM, I'd like an extra reviewer to also give their opinion.

[andrewpollock]

Not sure if you've seen #35 (I hadn't until today, by happy coincidence). It has a lot of the original thinking behind the introduction of last_affected and I wonder if it's worth at a minimum referencing, or if there's any useful material to further enhance this PR?

[hayleycd]

@andrewpollock I hadn't read through #35 before! It was interesting reading, but I'm a little wary of putting too much of that history in the schema. I feel like it may have the tendency to prompt more questions than it would answer and that section is already kind of long.

[oliverchang]

thanks! just some minor comments

[hayleycd]

Thanks @oliverchang ! I have addressed the comments. Let me know if there are any more changes.

[Marcono1234]

Should #150 and #146 now be closed? At least for me (author of #150) I think the recent changes clarify the usage of last_affected.

[hayleycd]

I agree.