There's a few things you could do to improve this good idea and not make it horrible.
- You definitely need to add screen keys.
- You should break it up into steps and use multiple gifs to show what you've done instead of just one long gif.
This eliminates the issue Scott raised that gifs are too long.
- Supplement the gif with a description of what you've done.
- Provide a download file with the complete project.
EDIT: I thought about this some more.
Gif technology is awful if you're not hosting funny short clips.
Gif is by far the worst video compression ever invented.
Google and imgur basically tried to irradiate gif completely with webm but failed massively.
What Google does now when you search for animated gifs is the preview is re-encoded as VP9, h264 or something similar. It saves A LOT of space and loads a lot faster. When you click on the preview it loads the actual gif file.
Using a real video compression format will have a lot of disadvantages.
For one the license involved for using h264 is expensive. You'd have to rely on another service like YouTube to host it so you don't have to worry about being sued. Your site visitors can't download the videos from YouTube easily like they could with a gif.
If you don't want to rely on YouTube as a host you could encode it in an open source video format.
Honestly I'm not even sure about the legality of some of the open source codecs. That's why google has been working on AV1 which still sucks.
Just use YouTube
Whatever short clips you'd save as gif you should just host on YouTube and embed it on your website. You don't have to make a long YouTube tutorial like everyone else does. Just break it in pieces like you would with gif and embed the videos in the same places next to supplemental text explanations like I said you should do with the gifs. Everything will load a lot faster on your site.
To clarify some noise in the comments.
There's no real difference between a YouTube video and a Gif.
They are both video formats.
The difference being that a YouTube video would load faster, have better color, and would also have the ability to pause (it's very important to pause).
.Gif is going to give you a lot of artifacts and improperly display colors because that's how gif works.
So wherever on your website you would place that 4 second gif instead it would be a 4 second video.
Why would you still want to use gif at this point?
If you use video from YouTube you can hide the videos from the public so that it's only seen on your website.
In the end if you do it the way I'm suggesting it will save you a lot of stress provide higher quality at a smaller size and it will allow people to easily view it on mobile phones that don't have high speed data.