https://futureofcoding.org/ logo
Join Slack
Powered by
Hello everyone! I was discovering how documentatio...
# share-your-work
m
Hello everyone! I was discovering how documentation for a programming language could look like - I came with my own engine for Я where you can click on every token in code snippets and follow it. As a demonstration, there are first 6 chapters on polished step-by-step tutorials demonstrating designing a command line task manager: https://muratkasimov.art/Ya/Tutorials/. And here is an example with deconstructing an regular operator: https://muratkasimov.art/Ya/Operators/kyokl/.
❤️ 1
🎷 1
🍰 1
i
Oh that's a really nifty idea! It makes exploring the code feel like falling down the Wikipedia rabbit hole. I'm curious — the description of Я mentioned that there are elements of visual programming embedded in the text interface. Can you share a bit about that?
I see various pill-shaped symbols, but I'm not sure what they mean. (I'm only very lightly familiar with category theory.)
Like, what's with the "stretched" versions of operators?
m
About visual programming - code you see on the site you can see in Visual Studio Code, you just need to install a special font, this is how it looks like:

https://www.youtube.com/watch?v=OJ6vb0mIiCU&list=PLzkSCNTBZnGj4KVpDHquWtf19e1ElvlbV&index=2▾

About pill-shaped symbols - each letter means something (like Y stands for Yoneda, L for limits, etc). I actually even generate most of those operators in codebase since composition of functors is a very easy thing.
About stretched operators - to each operator name you can add underscore symbol (
_
) to make it visually wider - it decreases precedence so that you don't even need parentheses to visually understand what is the order of operations.
i
That's super clever.
🙏 1
Yeah, this project is fantastic. I've shared it internally at Ink & Switch since I know a few folks there will find it interesting, and I added it to my Visual Programming Codex. I hope you'll continue to share more about it here in this slack. What's the current status of the project? I see lots of activity on Github, which is heartening.
👍 1
m
The core of the project is stable, I mostly working on better documentation and trying some ideas where it can be appliable.
👍 1
2 Views
Open in Slack
PreviousNext
Powered by