Upcoming Events Panel on Homepage not filtering correctly

[afewell]

Currently the events panel on the homepage displays all future events, rather than the desirable view of the next 3 upcoming events. This is because the solution to make this work is not clearly documented, is the method from the template did not work, and all the google search results I found to filter this correctly simply did not work.

I finally did figure this out, after attempting lots of different methods, the only method I found to work properly was using nested where statements: https://gohugo.io/functions/where/#nest-where-clauses

I am opening this ticket to document and to attach the closing pull request which will include the working code.