5 ms·
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
by yiyus 8y ago
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/examples/helloworld.ko https://github.com/kocircuit/kocircuit/blob/master/lessons/e... but I think it should be much easier to arrive there.
- giancarlostoro 8y agoThe law for making a new language: always include examples up front.
- agumonkey 8y agoUnless you want to filter for the most determined only !
- erwan 8y agoFor anything you want other people to use really
- sn41 8y agoEven 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-pedagogical-principle-examples-first/ https://gowers.wordpress.com/2007/10/19/my-favourite-pedagog...
- neuland 8y agoThis 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.
- desireco42 8y agoThank 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.
- mshockwave 8y agoCan't agree more. The readme/lessons looks very "academic" but I just want an overview.
- nikofeyn 8y agoisn'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.
- kierenj 8y agoI 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!
- mcphage 8y ago> 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.
- nikofeyn 8y agoyou missed my point of the poster not necessarily being the creator of the repository.
- V-2 8y agoPoster'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.
- andrewflnr 8y agoThe 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.
- staticassertion 8y agoThanks, came to the comments hoping someone could point me to code - I wasn't having any luck at all.