Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

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



Further to this, check out the page for Inko: 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.


When 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 :)


I like pyrets front page too for this https://www.pyret.org/ -- lots of examples and code-comparisons to other languages. Very neat.


Doesn’t seem to be the case on mobile?


In keeping with this, Python also has something similar: https://www.python.org/


Inko's page looks almost exactly like rust-lang.org used to look like in the past, before Rust rebranded their site for marketing reasons.


I'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


I 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.


Zig is the gold standard here. Every section of the site has a cide sample of.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: