summaryrefslogtreecommitdiff
path: root/src/2023/March/13.tex
blob: f1a93cc0431ee00d27f1a2f615690dabfec0dffd (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
\mytitle{Tutorial Implementation}{\dd}

Finally, the day I was looking forward to: implementing my tutorial video in
documentation development.

Despite looking forward to this day, I had a one complication that I did not
anticipate. The first thing that I had changed was the slideshow implementation
that I would use for the video. I had originally planned to use
Slidev\footnote{\url{https://sli.dev/}}, but I forgot what a pain it was to deal
with. I had worked with Slidev before in making complicated and articulate
technical slides that used a lot of custom logic and styling, but I forgot how
annoying it actually is to implement from scratch, especially for a simple
tutorial.

I switched over to Cleaver\footnote{\url{https://github.com/jdan/cleaver}}, a
really simple, command-line-based slideshow tool that compiles to a single HTML
file and uses Markdown for its content representation. I've also used Cleaver
before in simple presentations, and in hindsight, it should have just been my
first pick.

All in all, I'm surprised that I was able to get through the entire tutorial
with just one complication, and I think that the final video turned out pretty
well. I tried to be as clear as possible in my explanations, but in the field of
computer science, there's always room for improvement.