I have generated diagrams to help new people with haystack #9564
Replies: 4 comments 3 replies
-
|
Super cool approach. The "orchestrate" lines helped me mentally snap the dataflow into place faster than 30 paragraphs would. That said, curious how you handle edge cases — like fallback logic, retries, or async eval layers? Would love to see future versions show “real-world messy” flows too. Keep diagramming like you're mapping constellations. Most repos are just black holes. |
Beta Was this translation helpful? Give feedback.
-
|
Thanks for the kind words @onestardao! You can generate diagrams for free for projects that interest you here: https://www.codeboarding.org/demo. Let me know if you have any problems with it at ivan@codeboarding.org! So we generate the diagrams with static analysis and LLMs so edge cases should shown accordingly i.e. with looped nodes. However this might be quite low-level and for now on the demo we generate just 2 levels of depth. |
Beta Was this translation helpful? Give feedback.
-
|
Reply: Super helpful follow-up — thank you! That static + LLM hybrid makes a lot of sense. I’m definitely gonna try out codeboarding.org/demo — curious to see how far those 2 levels of depth can go. I imagine even partial edge mapping would already make onboarding smoother for most messy infra stacks. Let me know if you ever plan to support deeper async chains or reasoning paths (e.g., retry logic, caching layers, semantic branching). I’ve been playing with symbolic pipelines lately — might be fun to see how far these visual abstractions can stretch when paired with meaning-first systems. Great work — keep it coming! |
Beta Was this translation helpful? Give feedback.
-
|
Thanks if you want to try deeper paths you can install and try our vscode extension:https://marketplace.visualstudio.com/items?itemName=Codeboarding.codeboarding You can click on the down arrow for each component to generate deeper level's. Keen to hear what you think about it :) |
Beta Was this translation helpful? Give feedback.
-
|
Oh nice — just gave the extension a spin Would love to try pushing a few async edge cases soon — maybe even sneak in some symbolic recursion if I get bold enough |
Beta Was this translation helpful? Give feedback.
-
|
Awesome hearing that @onestardao! If you are interested to see how exactly we combined Static Analysis and LLMs you can head and see that there! |
Beta Was this translation helpful? Give feedback.
-
|
Ok I will check ^^ |
Beta Was this translation helpful? Give feedback.
Uh oh!
There was an error while loading. Please reload this page.
-
I generated diagram representation of the haystack codebase: https://github.com/CodeBoarding/GeneratedOnBoardings/blob/main/haystack/on_boarding.md
The idea is that the diagram helps new contributors by giving an overview of the codebase with it's main components. If you click on any of the components you see the same thing for the component itself!
Let me know what your opinion on diagram first documentation is!
Full disclosure: we're trying to turn this into a startup, but we're still in a very early stage and figuring out what will actually be useful for people. Also as many people brought that the diagrams will become outdated fast, we've introduced free github action!
Beta Was this translation helpful? Give feedback.
All reactions