rubex icon indicating copy to clipboard operation
rubex copied to clipboard

Created New UI for rubex docs.

Open Suhas010 opened this issue 8 years ago • 5 comments

Need some more time to create complete UI.

Suhas010 avatar Aug 20 '17 12:08 Suhas010

Hey,

I just had a look at the UI, and overall it looks really good and very well polished. Here's a bunch of things that would be great if changed:

  1. The first 'I love Ruby' part says 'I love C' as well. We use Rubex because we don't like C. Its too tedious to write. So we create an abstraction called Rubex. The color scheme is nice. Pink fits right in. So maybe you can have these three lines:
  • The elegance of Ruby
  • The power of C
  • Say hello to Rubex
  1. On the right hand side there's the paragraph on Rubex. How about removing the quotes and splitting it up like so:
Rubex is a language that makes writing CRuby C extensions as 
simple as writing Ruby. It does this by providing a syntax that is 
the perfect blend of the elegance of Ruby and the power of C. 

Rubex compiles to C and implicitly interfaces with the Ruby VM 
in a manner that is completely transparent to the programmer. 

Rubex keeps you happy even when writing C extensions.
  1. The paragraph appears too small for my screen (see screenshot). Maybe make it larger and increase the font size? Should be more in-your-face kind of. screenshot from 2017-08-21 22-29-11

  2. The 'Download Rubex' button should point to rubygems - https://rubygems.org/gems/rubex

  3. There should be another link called 'GitHub' on the navigation bar that points to the GitHub repo.

  4. The code samples on the home page are comparing Ruby with a C extension. They should compare a C extension (i.e. C code) on the left with Rubex on the right. So here's some further improvements to those:

  • The size of the font should be larger.
  • The padding that the code samples have should be lesser (ideally span the entire column).
  • The heading for the left side (C code) should be - `This C extension calculates Fibonacci numbers'.
  • The heading for the right side (Rubex code) should be - `This C extension also calculates Fibonacci numbers'.
  • And now we basically want to drive home the point that Rubex is a much better way of doing the same thing (i.e writing C extensions) so at the bottom of these columns you can write 'Rubex is better, right?` (bold, large font, again in-your-face kinds).

v0dro avatar Aug 21 '17 17:08 v0dro

Also, the code in code samples on the front page should have 2 space indentation :P

v0dro avatar Aug 21 '17 17:08 v0dro

Will make that changes and raise new PR

Suhas010 avatar Aug 21 '17 19:08 Suhas010

You can just push to this PR.

v0dro avatar Aug 23 '17 19:08 v0dro

Any update on this?

v0dro avatar Aug 28 '17 07:08 v0dro