Hacker News Reader

Comment by yiyus | Hacker News Reader

There is not a single example in the README. I checked the step-by-step guide, but it starts with installation and documentation instructions, then imports, and I don't know yet how the language feels like. Ok, let's check that handbook then. Computation model, type system, ...

Please, I just want to see a program with a dozen lines of code to see what it looks like. Of course, more extended examples with the intended usage would also be very welcomed.

I eventually found this: https://github.com/kocircuit/kocircuit/blob/master/lessons/e... but I think it should be much easier to arrive there.

View on HN

The law for making a new language: always include examples up front.

Unless you want to filter for the most determined only !

For anything you want other people to use really

Even in pure mathematics, a good rule is to give examples (if simple) right after the definitions. Examples always help.

Here's a post by the Fields medallist Tim Gowers:

https://gowers.wordpress.com/2007/10/19/my-favourite-pedagog...

This was my first reaction too. There are also no links between the steps. So, you have to go back and click to the next step from the file list.

Thank you for linking to example, I has same thoughts.

Also, looking at installation instructions, it is bootstrapped by Go, so it does seem it is still in some prototype phase.

I would say, let's give them a year or two.

Language, as language, looks clear enough for me, but it is hard to judge from little I saw.

Can't agree more. The readme/lessons looks very "academic" but I just want an overview.

Thanks, came to the comments hoping someone could point me to code - I wasn't having any luck at all.

isn't this a little demanding and entitled? for example, the submitter of this post to hacker news may not be the creator of the language and repository. so the creator is off just having some fun creating a language, with more than minimal documentation, and uploads it to github to track changes and generally make it public. then someone thinks it's interesting and posts it here, and the top comment is someone with too aggressive of a tone, in my opinion.

I don't think it's aggressive at all. They're literally presenting a language. A language. They talk about its virtues but I mean come on, how do you introduce a language?

Bonjour!

> isn't this a little demanding and entitled?

No.

The poster shared it to HN because they want other people to look at it. Which is fine, but they're asking for our attention, and they need to respect that fact—and us—and not waste our time. Sharing a new language but making us dig around to understand one of the most fundamental things about the language—what the code looks like—does not respect us, our time, or our attention. If that's a problem, they can keep it a private repo, and not share it on HN.

you missed my point of the poster not necessarily being the creator of the repository.

Poster's user handle is petar, and petar happens to have merged the latest PR in Ko repository, so I'd say there's a pretty good chance it is the same person.

The point of posting things on a site with comments is so people can comment on them. Even if we knew for a fact that the poster wasn't the creator, it would still be appropriate to comment on an annoying aspect of the project.

I am quite sure the reason my comment is at top is not because other readers appreciate my tone (which I don't find aggressive, although I admit it could be nicer) but because of the link.

Reply on news.ycombinator.com