- 
        Couldn't load subscription status. 
- Fork 33
Add Python tutorial #514
Add Python tutorial #514
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
My general observation is that the new page is duplicating a lot of the text from the Rust page.
@prrao87 Should we just use tabs for the language specific parts and make the rest common? Same as https://docs.kuzudb.com/get-started/#quick-start
| @sdht0 I've thought about this, and the main thing to keep in mind is user personas: a user who reads the Python code may not care about Rust, or Java, so they won't even notice that there's repetition. Having a dedicated page for each tutorial, clearly accessible in the sidebar for each user persona (Python developer, JavaScript developer, etc.) is paramount. Moving things into tabs makes it harder to discover in the docs, both in the sidebar and via the search box on top. We also don't know the implications of how LLM bots crawling our docs in the future may behave if we deeply embed the examples inside tabs. IMO repetition is fine from our (developer) perspective too - there are enough nuances with each programming language that there will be minor differences in code and subsections. Maintaining separate dedicated pages allows us the flexibility as maintainers, too. | 
| Alright makes sense. Another option is have a common file but programmatically generate the separate pages when deploying. That is of course beyond the scope of this PR. | 
Co-authored-by: Siddhartha Sahu <sid@kuzudb.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I reverted the sidebar link because we have other tutorials in Python (notebooks) to link to. Other than that, looks good to go!
Overall just a translation of the Rust tutorial. I also fixed a few things in the Rust tutorial.
For #510