Pacman tutorial website

[orzechow]

Let's split a first GitHub pages website from the pacman tutorial website.
This adds the Tutorial

Based on

• Add website #50

Closes #28

Depends on #53

[ll-nick]

I just changed the base to the demo branch and hopefully maybe didn't break stuff during the rebase.

[ll-nick]

Come to think of it, that didn't actually make too much sense. I changed to the demo branch because we need to remove some code from the demo so that it can be re-implemented.

But of course that part should be merged to main. I'll try and undo the rebase I just did.

[orzechow]

@ll-nick I fixed the git history by

• rebasing my state 1132327
• onto origin/main ae7038e and
• cherry-picking your two commits on top it.

[ll-nick]

Alrighty, here's a first draft, let me know what you think :)

The tutorial branch is all setup, too.

[ll-nick]

@orzechow I can't actually add you as a reviewer since you opened the PR. I assume you can give feedback anyway and should you be happy, I'll approve my own changes ;-)

[orzechow]

The tutorial quickly starts into the coding part – which I prefer against bloated descriptions 👌

Still, I'm thinking, if we should add a basics section explaining arbitration graphs in general – maybe as a sidelink or so.
IMHO we can't assume visitors are aware of our publication and know the concept.

If short enough, we could add this to the main Readme 🤔

@ll-nick what do you think?

[ll-nick]

Yes, that is a very good point. I think a short and concise description in the main README would be the very least of what we should do.
In the tutorial introduction, we could also link to a "theory" section where we go more in depth about the concepts, although we could also just link a paper there.

[orzechow]

In the tutorial introduction, [...] we could also just link a paper there.

Or paste some paper content in here.

[orzechow]

Ok, I finally got around to reviewing this :) First of all thanks for all the work you put into it, I think the tutorial is pretty awesome!

Thanks a lot for the thorough review and going through the tutorial once more 🙌

• I agree that it is better without task 3. Just the task numbering needs to be fixed now.

Done: d09deff

• The Browser title aren't super nice. Right now it says e.g. Arbitration Graphs Tutorial | arbitration_graphs instead of e.g. Arbitration Graphs Tutorial | Task 1

Alright, first draft: cbaf5aa
I'm not super happy with that, because the tagline adds even more redundancy. We could also use the existing menu_title (though shorter and without "Task 1:" prefix)
What do you think?

I won't wait with merging, though. We can further tune that in a small independent PR.

• The random switching doesn't so well because the random arbitrator switches too often. But I guess that's a separate issue.

Agree 👍

• When throwing an exception in a getCommand the demo will crash but I assume that this branch hasn't been rebased since Wrap getCommand in try-catch-block #21 was merged.

Rebased onto main