Hacker News new | ask | show | jobs
by thomasmg 265 days ago
I agree, IKEA instructions are great. A bit related are railroad diagrams, like the one of the JSON syntax [2].

I worked on Rubik's cube solving instructions for beginners [1] (for my children initially), but then I found it would be so much better if the instructions are IKEA style. (Then I vibe-coded a Rubik's cube 2D and 3D model, and now I stopped working on this. Something for later.) For the cube, I want to implement the algorithm, and then from the program create IKEA instruction (or a mix of IKEA and railroad diagram). That way I can be sure I didn't skip any steps in the instructions.

[1] https://github.com/thomasmueller/rubiks/blob/main/README.md

[2] https://www.json.org/json-en.html

3 comments

"I agree, IKEA instructions are great"

They are until you hit one for something that is so simple it does not really need instructions, then you will end up in a tail spin! We bought a window shade puller thing and it had instructions!

Lego are also superb at instructions, for obvious reasons. I've put together a couple of modern Lego models with a lot of pieces and they are still as good as I remember 40+ years ago. I have to say that the model of the Chinese Year of the Dragon beastie from 2024? was pretty tricky.

> Rubik's cube 3D model

Google had a doodle way back when... That let you play the cube on the search page.

I found it hosted here [1] although I'm sure they have a doodles archive. Didn't check it myself but it should be possible to take the JS from that and use it for our purposes.

[1] https://sites.google.com/site/populardoodlegames/rubik-s-cub...

> I'm sure they have a doodles archive

You are correct: https://doodles.google/

It doesn't seem to have the Rubik's cube, though

SQLite also has lots of excellent railroad diagrams for SQL syntax. e.g. https://sqlite.org/lang_select.html#overview