Skip to content
Notifications
Clear all

Hot take: The training videos are outdated and borderline useless.

6 Posts
5 Users
0 Reactions
1 Views
(@devops_rookie_james)
Estimable Member
Joined: 1 month ago
Posts: 116
Topic starter   [#18361]

Hey everyone, been using Grok for a couple weeks now to help with some CI/CD pipeline troubleshooting. I was really excited to see the training videos section, figured it'd be a great way to get up to speed on its features.

But honestly, I'm pretty disappointed. I tried watching a few, like the one on "Analyzing Log Output," and the UI it shows is from like two major versions ago. The buttons and menus are in completely different places now. It's confusing more than helpful.

As a junior engineer, I rely on current examples. If I'm trying to learn a tool, outdated materials make me doubt if the advice itself is still valid. For instance, a video on writing custom analysis rules references a deprecated CLI flag. I wasted an hour trying to get it to work before finding a GitHub issue saying it was removed.

Does anyone else feel this way? I'm curious what resources you all are using instead. Are the docs more reliable? Or is it just a matter of learning by trial and error?


Learning by breaking


   
Quote
(@george7)
Estimable Member
Joined: 1 week ago
Posts: 117
 

I've noticed this too, and it's a real pain point for new users. The video on the query builder is from the pre-dashboard redesign era, so it's essentially a different product visually.

The documentation is actually kept much more current, in my experience. I'd start there instead. For CLI changes specifically, the changelog is your best friend, as it lists deprecated flags for each release.

It's a shame, because a well-maintained video library could be so valuable. Maybe this feedback will prompt a refresh. Have you found any community-created content, like recent conference talks, that fill the gap?


Keep it constructive.


   
ReplyQuote
(@docker_diver)
Estimable Member
Joined: 1 month ago
Posts: 109
 

That's a really good point about the docs being more current. I guess text is just easier to update than re-recording and editing a whole video.

> the changelog is your best friend
That's true, but as a newcomer, I often don't know what to even look for in the changelog. I see a list of deprecated flags and I'm not sure what replaced them. Docs are good for structure, but sometimes I just need to see someone click through the actual UI, you know?

Are there any particular recent conference talks you'd recommend? I'm still looking for a good visual walkthrough of the new dashboard.


Containers are magic, but I want to know how the magic works.


   
ReplyQuote
(@devops_rookie_james)
Estimable Member
Joined: 1 month ago
Posts: 116
Topic starter  

Yeah, the changelog struggle is real. I've been there. Sometimes the replacement for a flag isn't even in the same changelog entry, you have to go digging in the docs for the new feature that superseded it. It's a puzzle.

For conference talks, I watched a pretty good one from DevOps Days London last year. The speaker walked through the current dashboard while debugging a pipeline failure. I can't remember the exact title, but searching "Grok dashboard walkthrough 2023" on YouTube should find it. The visual flow really helped me connect the dots.

Anyone else have tips for decoding changelogs when you're new to a tool? Do you just brute force search the docs for each deprecated term?


Learning by breaking


   
ReplyQuote
(@isabellag)
Estimable Member
Joined: 1 week ago
Posts: 58
 

Your frustration is completely valid, and it points to a broader maintenance problem with multi-modal documentation. While text-based docs can be incrementally updated, video content has a much higher update cost, leading to this exact version drift. This creates a significant, measurable learning latency for new users.

From a benchmarking perspective, I've observed that SaaS tools with a faster release cadence (e.g., quarterly major UI updates) often deprecate their video libraries entirely in favor of maintaining a single, constantly updated demo environment for users to explore. The cognitive load of reconciling an outdated UI with the current one, as you described, outweighs the initial benefit of the video.

To your specific question about resources, I've found the technical blog posts from the Grok engineering team to be a useful middle ground. They often include annotated screenshots of the current UI to illustrate a workflow, and they're published more frequently than full video tutorials. For CLI changes, searching the official docs for the exact error message you get from the deprecated flag will usually surface the updated syntax faster than combing the changelog line by line.


Measure everything, trust only data


   
ReplyQuote
(@cassie2)
Trusted Member
Joined: 4 days ago
Posts: 35
 

Great point about the demo environment as an alternative. I've seen that work really well for tools with rapid UI changes. It does put the learning burden on the user to explore, but at least you're exploring the real thing.

The technical blog posts are a solid recommendation. I find they're especially good for "why" behind a feature, not just "how." Annotated screenshots definitely hit that sweet spot between static docs and a full video.

I wonder if there's a role for super-short, single-feature video clips that are easier to re-record after an update, rather than these lengthy tutorials that become obsolete all at once.



   
ReplyQuote