8 ms·
I just want to compliment the OP on a very clear and comprehensive website at https://imba.io/ https://imba.io/. It clearly explains (by showing and telling) wh
by micheljansen 5y ago
I just want to compliment the OP on a very clear and comprehensive website at https://imba.io/ https://imba.io/. It clearly explains (by showing and telling) what Imba is, why I should care, how it works and how to get started. The floating demo applications even work well on mobile. Rare to see this level of polish for these things.
- nailer 5y agoOne piece of feedback: it took me a moment to work out what 'pt', 'o' and 'fs' were. Single character variables are fine for algorithms but for demos you really want to use actual words.
- linux2647 5y agoI’d agree If I’m using css daily I might know what these mean, but I only edit css once in a while, so most of these properties are lost on me
- greggturkington 5y agoI write CSS everyday and I had no idea what "fs" meant. "fz" is the typical shorthand used for font-size (at least by Emmet-style autocompleters). "fs" is used for font-style instead.
- scotty79 5y agoThose shorthands are optional.
- nailer 5y agoGreat but they shouldn’t be used in demos.
- rawoke083600 5y agoOh YES ! 100% - or if the demo spans "multiple files" but the code-snippets doesn't include a filename comment. I.e //app.js ... //my-todo.js ....
- dtagames 5y agoVery true! It's a great landing page for a language that gets into the meat of it right away with clear examples in code blocks. Nice work.
- gregsadetsky 5y agoVery true! One small note to the author: the “We are hiring” at the very top, on mobile, is a bit broken. It appears on three lines. It looks great in mobile landscape, but not in mobile portrait mode.
- antattack 5y agoOne thing that site does not specify is the Imba's license (MIT)
- Bellamy 5y agoWhat does it mean for projects build using imba?
- lhorie 5y agoNothing you should worry about. MIT is a very permissive license.
- knidoyl 5y agoOn side note, if you ever wonder what a licence means or do there is this website that help clarify this : https://tldrlegal.com/ https://tldrlegal.com/
- Noumenon72 5y agoYou have to worry about including the copyright and license in your software. I've never seen a project do that so I'm not sure how to do it or if MIT is actually usable.
- lhorie 5y agoThe attribution clause only applies to the licensed code, not derivatives. In practice, all this means is that you can use an unmodified copy of Imba (which contains its own license/attribution language) without issues. What's not cool is to fork Imba, remove the attribution to the original author and pass it off as your own code.
- system2 5y agoExact opposite of Elastic.co.
- meepmorp 5y agoEvery time I consult their docs, I feel like I have less of a handle on the topic than when I started.
- ziftface 5y agoHate to pile on, but I'm glad it's not just me. When I read their docs, I just get the feeling that I'm kind of dumb, or I just don't have the context they expect me to have.
- konart 5y agoThis. It almost like their docs is a cheat sheet for the Elastic devs, not for the end users.
- vosper 5y agoI think this might be partly due to the query language being JSON? It makes every example huge and hard to understand. JSON is a serialization format that's human-readable, it's not a human-first language. So it's a pity that's how you're expected to write searches (I know they have some SQL support now, but I've never seen it in the docs)
- konart 5y agoI don't think this has anything to do with json or examples in general. At least not for me. Quite often after reading their doc I just don't understand what result I should expect. Also the whole documentation simply lacks sane navigation. It's almost impossible to find anything there without google. In 50% of cases this is how it works for me (exaggerated): Question: how do I sum two integers? Expected Answer: You should use SUM(). The result of the function is the sum of two integers. Examples: 2 + 2 = 4 2 + (-2) = 0 -1 + (-1) = -2 Answer from Elastic docs: Well, you should execute this query agains this API, which will launch X subroutines in Elastic engine and the final result will be the result of of the aggregation of function defined by the Ex with En+1 being your query's body field Y with respect to url query param N.
- lhorie 5y agoI've noticed that some projects being complimented for having good docs come from CTOs (esbuild is another example). I'm hoping that by pointing out this little correlation, people might feel more inclined to spend more time on writing docs for their projects if they aspire to climb in the career ladder :)
- vijaybritto 5y agoThats a very good point. In my company whoever writes the most valuable and extensive docs are looked up by people automatically. Either for clarifications or just networking. For the past couple of months I have been making devtools for QA and documenting them and just recently found out that every single team uses them and got recognized for it in the all hands!!
- peakaboo 5y agoAny extra salary? No of course not. Lol.
- lhorie 5y agoAnecdata, but after I released Mithril.js, I started getting contacted by recruiters from Bay Area companies. I now make 4 times as much as I did when I first started working on it. I know of other folks that got poached by high tech companies due to growing prominence in open source. FWIW, my experience reflects GP that people really appreciate someone who takes the time to teach/help others. YMMV.
- fwip 5y agoI love the font chosen for the demo code, the descender on the f is very charming.
- cutemonster 5y agoI thought so too
- js6i 5y agoIs it just me? This website is super laggy on my PC (which can run modern games just fine). Hardly hits 50 fps when scrolling. How slow can one get and still claim to be fast?
- p1necone 5y agoNot just you, I have a pretty beefy desktop and it's noticeably laggy when scrolling for me too. EDIT: ah - butter smooth in edge (and presumably chrome too), but laggy in firefox.
- p1necone 5y agoFurther update - it turns out I'd turned off Hardware Acceleration in FF to avoid issues that Windows has when you have GPU accelerated content on two separate monitors with different refresh rates. It's really bad with Hardware Accel turned off, but it's still a bit laggier with it on compared to chrome/edge.
- somebee 5y agoYeah, it's not really optimized for that. The floating labels over the code examples are offset in 3d space (for a subtle parallax effect while scrolling), so when HW acceleration is off it may end up repainting the page on every scroll. The effect is probably not worth the tradeoffs :)
- Shorel 5y agoFirefox 91 on Windows. 2011 CPU. Radeon RX 570 GPU. I have a low spec PC, and it is running just fine. Maybe some extension slows down your Firefox? I don't use an anti-ads and anti-spam extension, I deal with that via hosts file.