6 ms·
Hey if I can make a small recommendation, I’d suggest putting some code examples directly in the readme. Currently the examples are buried multiple pages into
by jlukecarlson 7y ago
Hey if I can make a small recommendation, I’d suggest putting some code examples directly in the readme.
Currently the examples are buried multiple pages into the documentation, making it harder to evaluate the project at a glance
- admay 7y agoI'd like to just add a +1 to this. I had a tough time finding some good code examples and would love to see a small example of code in the readme. Something beyond a hello world, preferably but that's just me
- vosper 7y agoFurther to this, check out the page for Inko: https://inko-lang.org/ https://inko-lang.org/ They have a nice little dropdown in the top corner, right there on the front page, that lets you see little code snippets. I really like that. Should slightly more accessible code snippets have any influence on my choice of language? Probably not. But I like it nonetheless.
- YorickPeterse 7y agoWhen making the Inko website I saw a bunch of other language websites (e.g. D's website) use this approach, so I copied the idea. I'm glad it turned out useful :)
- azinman2 7y agoDoesn’t seem to be the case on mobile?
- whammywon 7y agoIn keeping with this, Python also has something similar: https://www.python.org/ https://www.python.org/
- grok2 7y agoI like pyrets front page too for this https://www.pyret.org/ https://www.pyret.org/ -- lots of examples and code-comparisons to other languages. Very neat.
- lilyball 7y agoInko's page looks almost exactly like rust-lang.org used to look like in the past, before Rust rebranded their site for marketing reasons.
- bobajeff 7y agoI want to add that it's helpful to describe the kinds of problems it addresses and to show how. Is love to see a presentation on it.
- rishav_sharan 7y agoZig is the gold standard here. Every section of the site has a cide sample of.