top | item 21993088

(no title)

jlukecarlson | 6 years 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

discuss

order

vosper|6 years ago

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.

YorickPeterse|6 years ago

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

grok2|6 years ago

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

azinman2|6 years ago

Doesn’t seem to be the case on mobile?

lilyball|6 years ago

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.

admay|6 years ago

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

bobajeff|6 years ago

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.

rishav_sharan|6 years ago

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