Document built in Timetables

[collinmcnulty]

Adding descriptions of the 3 built in, user-facing timetables to the Timetables doc page.

[collinmcnulty]

@jedcunningham adding this documentation as per your suggestion.

[github-actions]

The PR is likely ready to be merged. No tests are needed as no important environment files, nor python files were modified by it. However, committers might decide that full test matrix is needed and add the 'full tests needed' label. Then you should rebase it to the latest main or amend the last commit of the PR, and push it with --force-with-lease.

[uranusjr]

Not sure what’s going on but code blocks are failing. Maybe the imports must be added?

[eladkal]

@collinmcnulty can you please check the test failures?

[ashb]

@collinmcnulty Something went very arry here with this PR, shout if you want a hand rebasing it.

[collinmcnulty]

Oh geez. Yeah, I thought I did the rebasing but obviously things fell apart.

[jedcunningham]

Couple nits.

[collinmcnulty]

I'm at a loss. Do the example blocks need to be fully functional standalone python code? Is there some way to tell the CI that they're not?

[uranusjr]

They don’t need to be strictly functional, but must be valid Python syntax. So the easiest way to get around the checks is to just add

def dag():
    ...

under those decorators.

[jedcunningham]

🎉 Thanks Collin!