7 ms·
Io Programming Language (new website design)
- ademarre 11y agoIf it were up to me I might stylize the name in uppercase "IO" or lowercase "io", and encourage the user community to do the same. "Io" looks too much like "lo" (lowercase L). And being a proper noun, people will almost always write "Io", which is the most problematic form it could take. I generally don't like stylized letter case, but in this instance I think it would serve a useful purpose.
- dasmithii 11y agoI honestly prefer the old design. My two cents.
- smt88 11y agoThis is really poor design from a UI/UX perspective. I spent 5 seconds on it and already uncovered the following problems: 1. It says nothing about Io on the front page except "A programming language". That's cute or edgy or whatever you want it to be, but it's not a good way to market a new language and spread adoption. No user should have to click to find out what your product is. There is way too much clicking here in general. 2. Terrible use of space. The "navigation" (if you can call it that) on the front page runs past the fold on my screen. The text is huge. On other pages, the text is tiny and hard to read because it's white-on-black. 3. Layout completely changes for different screen sizes. I know this is popular, but when it can be avoided, it's better to avoid it. When people see the same layout on all screens (or as close as you can get), it makes usage of the site faster. For a site that has language docs on it, this is really important.
- stevedekorte 11y agoThanks for the helpful feedback. It's a work in progress.
- smt88 11y agoYou'll learn more from watching someone use the site than you can learn from me. Here's a good exercise: 1. Write down the top 5 goals that someone coming to the site might want to reach. For example, "Find out what Io is" is probably #1, "See what the syntax looks like" is probably another, and "Learn the benefits over other languages" is probably a third. You'd be able to come up with a better list than me by looking at your analytics (what pages people visit most). 2. Write these goals down. Then ask someone who has never seen the site before to accomplish them right in front of you. Don't explain anything and don't interact with them until they're done. Make sure you keep a timer to see how long it takes. 3. After they're done, ask them what they found clear, what they found confusing, and what else they might want to see on the site.
- stevedekorte 11y agoGood points. I'd be very interested to see your version of the design if you had time to put something together.
- smt88 11y agoEdit: Rust's website has an open-source license[3]. You can copy the code and use it directly! That's great news because they host it on S3 with Jekyll, which is ridiculously inexpensive. I'm not an expert or a designer. Your users will show you how to improve the design because you'll see evidence of where they're getting tripped up. For example, if a certain page is the last one most people see before leaving the site (other than front page), then you can tell that page A) solves a problem, or B) causes people to lose interest. A good starting point is to look at other language sites and decide which ones seem friendliest and least friction-y. How easy it is to get started? As examples, I really like Rust's website[1], and Elm[2] is pretty good, too. Rust's site is great because it's readable, all the important stuff is above the fold, and it has big action buttons. They also give a fairly long example of syntax, which is important. I've even seen some languages that will show a snippet of code in an existing, comparable language, along with that same snippet translated into the new language. That's a great way to make your language accessible. 1. https://www.rust-lang.org https://www.rust-lang.org 2. http://elm-lang.org http://elm-lang.org 3. https://github.com/rust-lang/rust-www https://github.com/rust-lang/rust-www
- _RPM 11y agoIt would be nice if it explained the internals a little bit. Like $X language is a interpreted duck typed language, or $X is a language with a jit that compiles to x86 byte code
- stevedekorte 11y agoGood suggestion. Thanks.
- chm 11y agoI want to add that the tutorial page is useless IMO. You should definitely consider adding syntax highlighting and using a different font. It's totally unclear. Sadly, after multiple clicks I still have no idea if the language could interest me, and I'm not going to look further. :/
- illumen 11y agoTutorial useful for me. Minimal website great. Like IO, I guess.
- stevedekorte 11y agoThanks for the suggestion. I've tried to fix it up a bit. What do you think?
- chm 11y agoLooks much better to me. I would also change the font family to a monospaced font, such as Fira Mono[1]. That would be two small modifications that lead to better readability IMO. If you want it even fancier, I found this page[2] that can highlight and format Io code... [1]:<link href='https://fonts.googleapis.com/css?family=Fira+Mono' https://fonts.googleapis.com/css?family=Fira+Mono' rel='stylesheet' type='text/css'> [2]: http://hilite.me/ http://hilite.me/
- nicerobot 11y agoAdditionally, light on dark is horrible for readability. That theme is great for imagery but it's doesn't provide valuable contrast for clearly rendering fonts. Programming docs are typically mostly text so should provide the best colors that support readability.
- imakesnowflakes 11y ago>Additionally, light on dark is horrible for readability. I have a hard time understanding this. Staring at a bright background hurt my eyes after a while. White text on a black background feels much more comfortable to read. What am I missing?
- Absentinsomniac 11y agoI agree with this. We've gotten a bit of flack on blog.darknedgy.net for this, and we've been putting off making a light-background alternative theme. I'll get around to it eventually because people want it, but I prefer the darker background with lighter text. It feels easier on the eyes for me, personally. And really, folks who have complained have been the minority anyway. For us anyway.
- smt88 11y agoYou should read the link I posted in the sibling to your comment[1]. You may personally feel that light-on-dark is better, but your visually-impaired users will disagree. This includes a huge number of older users, as eyes deteriorate significantly with age (even among people in their 40s and 50s). Also, you have no idea whether the complainers are in the minority or not. The people it bothered probably didn't stay long enough to figure out how to complain. Do you get compliments from people who say that they're glad you use light-on-dark? 1. http://graphicdesign.stackexchange.com/questions/15142/which-is-easier-on-the-eyes-dark-on-light-or-light-on-dark http://graphicdesign.stackexchange.com/questions/15142/which...
- silon7 11y ago
- cdcarter 11y agoThe design is very much just a spruced version of the Io website that I remember from 2008. Not super fancy, not super verbose, much like the language itself.
- smt88 11y agoI also considered whether the website reflects the language itself. If it does, I wouldn't want to use the language, because it seems to prioritize faux-simplicity and having a unique design over usability. Thankfully, the website creator seems to be actively reading our feedback and interacting with us as users, which makes me think the language itself is probably developed with the same pragmatism, humility, and curiosity. Those are all great characteristics for someone designing a language!
- throwaway1 11y agoYou're clearly an expert on humility.
- dang 11y agoNo personal attacks, please.
- slewis 11y agoCounter argument. Usability does not have to be number one. There are lots of programming languages out there. What if one had a unique take on a website? It's healthy for people to try new takes on things. I laud the approach. I think it looks cool and on first glance makes me think, "wow, this doesn't look like it was made by engineers who only think practically, maybe I'll go further to see if there are some unique ideas in the language itself". In other words, don't speak like there is only one true way to do things, especially when you're critiquing someone else's work. (this last statement is slightly in jest as I'm doing the same to you!)
- brianmurphy 11y agoBikeshedding - if they can't make a website, how are they supposed to make a good programming language?
- smt88 11y agoI agree that language design isn't related to website design. However, how widely-used a language is matters a lot to me. I'd wager that it matters a lot to most people. And a language's user base is definitely affected by its website design. How much is it affected? I really don't know.
- smt88 11y ago> In other words, don't speak like there is only one true way to do things You're absolutely right. I made some assumptions and let my own values come through. My assumptions are 1) that this developer wants his/her language to succeed, 2) that a language succeeds because it's usable/accessible, and 3) that this design is not usable/accessible. #2 and #3 are totally debatable, which is why I told OP not to take my word for it and to observe users instead. I'm just one user, and not an expert or designer.
- drewm1980 11y agoI agree; I came back here to read comments to get some idea what the language is all about. He/She could have just babbled a little about what makes their language special in a static html page with zero formatting, and included a github link, and it would be more effective.
- babo 11y agoThe about page is just a click away. On your third visit that part would be irrelevant, I prefer to put it in a separate page.
- galfarragem 11y agoCompletely agree. Nice website examples for general purpose programming languages IMO: http://www.scala-lang.org/ http://www.scala-lang.org/ https://www.haskell.org/ https://www.haskell.org/ http://www.gnu.org/software/guile/ http://www.gnu.org/software/guile/ For altJS languages: http://coffeescript.org/ http://coffeescript.org/ EDIT: Some websites that could be 'freshened up': http://elixir-lang.org/ http://elixir-lang.org/ http://elm-lang.org/ http://elm-lang.org/ https://www.python.org/ https://www.python.org/ Some websites that definitely should be 'freshened up': http://clojure.org/ http://clojure.org/ http://www.lua.org/ http://www.lua.org/
- swah 11y agoTo be fair the old website was perfectly in sync with the io idea.
- netghost 11y agoIf you want to learn about prototypical languages, I think Io is a great place to start. http://iolanguage.org/guide/guide.html#Objects-Prototypes http://iolanguage.org/guide/guide.html#Objects-Prototypes
- aaron-lebo 11y agoSo Io has always fascinated me from a design perspective (also see Ioke) [1], but it's almost too dynamic. It is hard to make efficient. What changes could you make to it in order to make it easier to compile? Or what changes would you make to it in general? I adapted similar syntax to Clojure semantics with prose [2], but Io has some unique semantics that come with some trade offs. 1. https://ioke.org/ https://ioke.org/ 2. https://github.com/aaron-lebo/prose https://github.com/aaron-lebo/prose
- shmageggy 11y agoOne thing I would have liked to find was a use case. What problem can I solve more easily or elegantly in Io than in the languages I currently use? I've checked out both Juila and Go because they showed me how to do something I wanted to do in a way that was really nice. Without that, I don't have much to motivate me to play with it.
- stevedekorte 11y agoThat's a good point. Thanks.
- fithisux 11y agoI would have expected it to be a new scripting language (Oriented towards AppleLand -> IOS / Darwin) In this respect I wouldlike to see more GNustep integration (but this a GPLers dream). I would trade it for better documentation though which really kills IO. Despite this, one should mention the inclusion of BaseKit. His implementation of data structures.
- stevedekorte 11y agoWhich aspect of the documentation do you feel needs work?
- fithisux 11y agoAn entry in learn X in Y minutes. An some non-trivial examples in "tutorial".
- deleted 11y ago[deleted]
- overgard 11y agoI'm not against jargon outright, but io could use some better copy, it doesn't do the language credit (its pretty cool!). The first sentence of the about page is: "Io is a homoiconic prototype-based programming language". I guess that's an accurate description... but if you're clicking "about" presumably you're making up your mind about if this is worth more of your time or not. I'm guessing even most of the brightest programmers have never even heard that word. If you know what homoiconic means you're probably the language designer, a lisp hacker, or a regular at lambda-the-ultimate.
- raspasov 11y agoI applaud the author(s) for working on something so ambitious. A concurrency question: How does the issue of lost updates get handled when two separate threads/co-routines/et al try to modify the same piece of data?
- cdcarter 11y agoBack in 2008 (when I was 16, as the sample data so helpfully reminded me) I wrote a very basic web framework for Io based on _why's Camping framework. https://github.com/cdcarter/backpacking https://github.com/cdcarter/backpacking It hasn't seen much love in a long time, but it was great to be reminded of why that language was so fun to work with!
- handrake 11y agoPlease visit the web site for Go language and try to adopt their design because yours simply is not acceptable in every way. I don't wanna click menus just to find out what language paradigms are for your language because I absolutely expect to find them on the first page...
- Raed667 11y agoWith all that "blank" space I expected that I shouldn't have to scroll on a 15" screen ..
- big_paps 11y agoI also miss a usecase. And speaking of the homepage: This looks untransparent and unfriendly. I think the laravel homepage is extremly well made. Clean and very good documentation which you can use all the time without getting angry. http://laravel.com/docs/5.1 http://laravel.com/docs/5.1
- fractallyte 11y agoIn contrast to some here, I think this is a strikingly different, minimal, lovely design! Admittedly, the sub-pages should be spruced up with more color and better layout (they're just too minimalist to convey important concepts about the language). I think these should be more in line with other language showcase websites. As for the 'too much clicking' criticisms: no, it's no great hardship to hit that 'About' menu item!
- riffraff 11y agobut the previous website[0] was also minimal and yet (IMVHO) a lot more effective (and a lot easier to read)[1]. [0] https://web.archive.org/web/20151103063328/http://iolanguage.org/ https://web.archive.org/web/20151103063328/http://iolanguage... [1] EDIT: I am slightly astygmatic, so for me thin white lines on black BG are basically just horizontal fuzzyness. To be constructive: white on black is generally less readable, but it can be somewhat compensated by adding more leading and thicker lines, so i.e. in /about adding this to .text font-size: 16px; font-weight: normal; letter-spacing: .015rem; makes it a lot easier to read.
- stevedekorte 11y agoThanks. Which subpages and which parts do you feel should have which colors?
- fractallyte 11y ago'Guide': each section has many subsections. When browsing through, it's easy to become disoriented due to the 'sameness'. Numbered titles/subtitles would be easier to navigate. Syntax coloring would add life to the monotones. 'Tutorial': the dark background and proportional typeface is out of character with some of the other code examples. (I happen to prefer mono-spaced code, with syntax coloring.) Examples: https://www.haskell.org/ https://www.haskell.org/ http://www.gnu.org/software/guile/ http://www.gnu.org/software/guile/ https://www.ruby-lang.org/en/ https://www.ruby-lang.org/en/ https://lfe.gitbooks.io/quick-start/content/2.html https://lfe.gitbooks.io/quick-start/content/2.html Other than that, I'm not sure I'd change much else, design-wise...
- deleted 11y ago[deleted]
- jdkanani 11y agoFirst, I thought my internet connection went down while loading and half of stylesheets weren't loaded properly. Second, I didn't know where should I click first. Language site doesn't need good UI, just provide what it is and why we should go ahead with it and minimal examples on front page.
- goldenchrome 11y ago>Language site doesn't need good UI, just provide what it is and why we should go ahead with it and minimal examples on front page. What you're describing is actually good UI. A good UI makes it easy for people to do what they're trying to do.
- jdkanani 11y agoGood UX, not UI make it easy for people to do what they're trying to do.
- deleted 11y ago[deleted]
- elcct 11y agoIs this another PERL clone?
- gkya 11y agoThe old website was perfect. I think they should return to it ASAP.
- bsaul 11y agoyou should add a code example illustrating the difference of your approach on the front page. i had to click many times to find the first code, which i only did because the link came from HN, and it had lots of comments. Also, a "word about the authors" would be nice. is it coming from research, industry, or hobbyists.
- KuhlMensch 11y agoGuys, complete your austere hipster website with an appropriate url. Might I suggest http://lang.io http://lang.io
- on_and_off 11y agoI am discovering Io with this article so I have no opinion on this new design compared to the old one. Some random thoughts : -the first page provides no information at all, other than it is a programming language. -The about page is just slightly better. I get a list of features and nothing else. samples of how it looks like in practice would be welcome. -Not a word about tooling, even though it is a crucial point. If I compare this with Kotlin's web page : -brief description of the language -then gives me a couple of reasons to use it -then shows me some base samples -a list of ways to try it out -even an online editor to try out the language Kotlin's webpage could probably be lightened a little bit, but it displays all the relevant base information about the language.