From my AI (Claude Opus 4.7) to yours,
Fetched
https://wimblerobotics.github.io/
Brief critique to share with Mike:
Strengths
- The "Start With the Problem You Have" entry pattern is
genuinely unusual and well-executed — most ROS knowledge bases
force you into a taxonomy first; this lets a frustrated builder
land directly on a likely answer. It's the most user-empathetic
ROS site I've seen.
- Topic-hub layering (Foundations / Navigation / Perception /
Hardware / Software / DevOps) maps cleanly to how a robot
actually fails, not how the API is organized. Putting
Foundations first (REP 105, TF2, URDF as "frame translation
system") signals a teaching mindset rather than a recipe site.
- Editorial-not-encyclopedic stance is brave and correct. The
promise that articles "summarize" and "point to a stronger
original source" inoculates against the usual stale-fork
problem.
- Markdown-first / Obsidian-vault / GitHub-repo / MkDocs
Material triple deployment is the right call — it keeps content
portable and contributable.
- Tag glossary plus contribution template signals an actual
digital-garden discipline rather than a one-author dump.
Suggestions worth raising
- Consider adding small "scope stamps" on each note: ROS 2
distro tested, robot class (indoor wheeled / outdoor / arm), and
last-verified date. Knowledge rot is the eventual enemy of every
site like this.
- A "what this article will NOT cover" boilerplate line per page
would short-circuit a lot of disappointed bounces.
- For navigation/perception articles, a tiny diagram (data flow
with topic names) outperforms two paragraphs of prose. MkDocs
Material handles Mermaid natively.
- The "Solve a Problem" notes and the Topic Hub articles risk
drifting apart over time. A bidirectional "this note expands the
[Hub] section X" header keeps them coherent.
- The contributor template is a great gate, but consider a
one-paragraph "house style" note on tone — the existing pages
have a recognizable voice (terse, opinionated, anti-cargo-cult)
that newcomers won't reproduce by accident.
Overall: it's already the kind of resource I wish existed when
people started learning Nav2. Tell him it reads like the missing
middle layer between the official docs and a senior engineer's
whiteboard.
James H Phelan "Nihil est sine ratione cur potius sit quam non sit" Leibniz
--
You received this message because you are subscribed to the Google Groups "HomeBrew Robotics Club" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hbrobotics+...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/hbrobotics/8609C23D-4FD9-4A84-A6EF-3B4617A89617%40gmail.com.
Very nice. I reviewed URDF, camera/vision, ROS2 rclcpp + launch files, etc.
Good structure template with description, pointers at two or more levels.
Building out many topics & subtopics, then curating each with actual use ramping people up, will make this a valuable resources.
Over time, it would be nice to add:
Club examples, videos.
Hero images, quick video clips, samples / sample code (example URDF snippet, a few salient lines of C++).
Also, overall, creating the basis for a roadmap would be nice.
These are good examples of one way to do it, with some good
content:
Stephen
--
You received this message because you are subscribed to the Google Groups "HomeBrew Robotics Club" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hbrobotics+...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/hbrobotics/8609C23D-4FD9-4A84-A6EF-3B4617A89617%40gmail.com.
|
Stephen D.
Williams
Founder: VolksDroid, Blue Scholar Foundation |
--
You received this message because you are subscribed to the Google Groups "HomeBrew Robotics Club" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hbrobotics+...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/hbrobotics/C944F099-B240-46B4-A309-88DDA44F4EA0%40gmail.com.
To view this discussion visit https://groups.google.com/d/msgid/hbrobotics/CAArUYGtSdkpibHT80Qvh5v%2BTHO3ehHW0%2BYrk%3D-y9JKKjpuT_0Q%40mail.gmail.com.