Ruby.on-page.net - Evolution began

Ruby
1

How many times have you ever needed to find just one argument of a
method/function/operator or just some word of syntax while working?

For example, in web development, you really need to work with many
programming languages (ruby/python/perl/php/sql…), scripts (js/
as…) and standards (HTML/CSS…). So, it is very hard to remember
all details…

The first thing you have to do is to google it or to use the index
of .chm or just Ctrl+F thru some manuals or pages… and as a result
you have a lot of garbage and you need to search again for some useful
sample or description.

On-page.net - is an attempt to reduce the garbage and give to you just
what you really need.

The idea is this: only one page with information blocks. Each block
can describe from one to a few keywords. All the keywords are
marked(indexed) by block creator (No machine index and search! Closer
to Web 3.0). Every visitor can add, modify and/or delete a block, but
all changes will be pre-moderated.

As a result, you have a page where you can find a useful sample or a
description of any keyword or symbol, just by typing it right in your
browser. You don’t even need to use Ctrl+F… and you can navigate
between keyword places via arrows or F3.

Ruby.on-page.net - is just the beginning of new level of online help.
For now it is just a beta version of the engine and for only one
language - Ruby (includes just some scraps from “Programming Ruby”).
Now I am trying to improve the functionality, stability and
performance of the interface. Also, it must work cross-browser and
support many languages and localizations. What I really need now is
your advice and ideas, or any feedback that can help me to make it
better and useful. Try not to concentrate on bugs and errors, but
think about what is good and what is bad…

You can try it right now (for now just in Firefox) -

All your things you can post here, you can mail me ([email protected])
or you can use the feedback form on the site’s page.

Why have I posted here? It’s because Ruby inspired me to make the life
easier …

2

Des wrote the following on 10.03.2007 20:15 :

You can try it right now (for now just in Firefox) - http://ruby.on-page.net

Seemed interesting, but doesn’t work with Firefox 2.0.0.2 on Linux.

3

On Mar 10, 9:24 pm, Lionel B. [email protected]
wrote:

Seemed interesting, but doesn’t work with Firefox 2.0.0.2 on Linux.

It’s bad :frowning:
For now I worked only with Firefox 2.0.0.2 on Win.
I you can, please write about what exactly don’t work?

4

Alle sabato 10 marzo 2007, Des ha scritto:

On Mar 10, 9:24 pm, Lionel B. [email protected]

wrote:

Seemed interesting, but doesn’t work with Firefox 2.0.0.2 on Linux.

It’s bad :frowning:
For now I worked only with Firefox 2.0.0.2 on Win.
I you can, please write about what exactly don’t work?

I’m using firefox 2.0.0.2 on Linux (gentoo, package mozilla-firefox-bin)
and
it works. It’s nice, but I think many users will confused by the fact of
not
having to look for a text field to enter the text (at least, I was).
Blindly,
I tried to write require… and it worked! After that, reading again the
text
at the top of the page, I found that it was written in the lines below
“Just
type the word or symbol you are looking for”. In my opinion, this
should be
stressed much, much more.

Stefano

5

Des wrote the following on 10.03.2007 20:35 :

I admit the error pissed me off and I forgot to make my message
usefull… My apologies.

The first page gives me :

Version for your browser is in development… For now page works only in
Firefox http://www.mozilla.com/en-US/firefox/

Which is slightly ironic given that I use Firefox (note: although I use
the NoScript extension, I authorized scripts for your site temporarily
and it didn’t work better)…

Lionel

6

Des wrote the following on 10.03.2007 21:15 :

[…]
Browser detection is based on the user-agent string. Can you send me
the user-agent string of your browser?
You can alert see with

Mozilla/5.0 (X11; U; Linux x86_64; fr; rv:1.8.1.2) Gecko/20070304
BonEcho/2.0.0.2

Yeah, BonEcho… Apparently Mozilla put some restrictions around the
Firefox name (I’m using Gentoo but with Firefox compiled from source
unlike Stefano). May I suggest you check for Gecko (maybe with a minimum
version if you need to)?

Lionel

7

On Mar 10, 9:57 pm, Lionel B. [email protected]
wrote:

and it didn’t work better)…

Lionel

Browser detection is based on the user-agent string. Can you send me
the user-agent string of your browser?
You can alert see with

8

On Mar 10, 10:03 pm, Stefano C. [email protected] wrote:

In my opinion, this should be stressed much, much more.

Thanks for the comment. I have stressed it with underline…

9

Hrm 3rd try… had some trouble replying to your messages, Evolution
tries to post it to a newsgroup. Here goes:

It appears to be working fine here, FF 2.0.0.2 on Ubuntu Linux. It
certainly is easy to search, but the amount of information on one screen
is a bit overwhelming imho.

Maybe it would be neat to ‘grey out’ the rest of the blocks when you’re
doing a search, so it’s easier for the reader to focus on the relevant
information.

Also, I think the font is a bit small :slight_smile: And the ‘search box’ content is
sometimes a bit slow on the updating. For example, if I type ‘Hash’ at
my normal typing speed, it only shows ‘Ha’. I have to type slow for it
to work.

Lastly, maybe it might be a nice idea to make the ‘search box’
permanently visible, which could be handy if you want to paste search
strings. It would also make it easier for first-time visitors.

It seems like a good idea though, I’ve always been annoyed at the lousy
interface of RDoc Documentation which makes it a pain to
search for things. Keep it up :slight_smile:

10

Des wrote the following on 10.03.2007 21:35 :

I just have added BonEcho to trusted browsers. Can you try it now?

The main page is loading. Looking around…

Lionel.

11

Alle sabato 10 marzo 2007, Des ha scritto:

On Mar 10, 10:03 pm, Stefano C. [email protected] wrote:

In my opinion, this should be stressed much, much more.

Thanks for the comment. I have stressed it with underline…

It’s better, but I’d put it first in the list. Besides (it may be
because of
my browser’s settings, I seldom use firefox), that text is shown in
light
gray, which makes less evident than it should be. Maybe, you could
consider
changing the color with something darker.

Stefano

12

On Mar 10, 10:24 pm, Lionel B. [email protected]
wrote:

Yeah, BonEcho… Apparently Mozilla put some restrictions around the
Firefox name (I’m using Gentoo but with Firefox compiled from source
unlike Stefano). May I suggest you check for Gecko (maybe with a minimum
version if you need to)?

Lionel

I just have added BonEcho to trusted browsers. Can you try it now?

13

On Mar 10, 10:41 pm, Stefano C. [email protected] wrote:

changing the color with something darker.

Stefano

You are fully right! Thanks again.

14

On Mar 10, 10:28 pm, Choong Wei T. [email protected] wrote:

It appears to be working fine here, FF 2.0.0.2 on Ubuntu Linux. It
certainly is easy to search, but the amount of information on one screen
is a bit overwhelming imho.

Maybe it would be neat to ‘grey out’ the rest of the blocks when you’re
doing a search, so it’s easier for the reader to focus on the relevant
information.

Yes… but some context must be saved, how do you think?

Also, I think the font is a bit small :slight_smile:

In the future it can be like some option or automatic adjustment by
screen resolution…

sometimes a bit slow on the updating. For example, if I type ‘Hash’ at
my normal typing speed, it only shows ‘Ha’. I have to type slow for it
to work.

Yes, there is a lot of work for optimization…

Lastly, maybe it might be a nice idea to make the ‘search box’
permanently visible, which could be handy if you want to paste search
strings. It would also make it easier for first-time visitors.

I really have forgot about pasting :slight_smile:

Thanks for your reply!!!

15

Wow. I am thoroughly impressed. What an elegant way to show and sift
through documentation.

Very nicely done.

Nathaniel.

On 3/10/07, Des [email protected] wrote:

gray, which makes less evident than it should be. Maybe, you could consider
changing the color with something darker.

Stefano

You are fully right! Thanks again.

–
Nathaniel Steven Henry Brown

Toll Free: 1-877-446-4647
Vancouver: 604-724-6624

16

On Mar 10, 10:28 pm, Choong Wei T. [email protected] wrote:

Lastly, maybe it might be a nice idea to make the ‘search box’
permanently visible, which could be handy if you want to paste search
strings.

Now you can paste strings! Just open the page and press Ctrl+V,
without any input box…

17

Hi,

In message “Re: Ruby.on-page.net - Evolution began”
on Sun, 11 Mar 2007 05:35:05 +0900, “Des” [email protected]
writes:

|I just have added BonEcho to trusted browsers. Can you try it now?

Could you add Iceweasel for poor debian users? My user-agent line is:

Mozilla/5.0 (X11; U; Linux i686; ja; rv:1.8.1.2) Gecko/20070208
Iceweasel/2.0.0.2 (Debian-2.0.0.2+dfsg-3)

          matz.
18

On 3/10/07, Des [email protected] wrote:

Sorry I am not an expert but I read lots of things about this stuff.
It seems that your method of browser detection is not the err very best.
Firefox disguises itself sometimes - and sometimes it needs to do so
when mean Proxys are serving Internet Explorer only!!.

Maybe you find the following useful
http://www.quirksmode.org/js/support.html

BTW works fine with my Firefox 2.0 on Zenwalk.
This is impressive although I have to admit that one has to get used to
it.

Cheers
Robert

19

On Sun, 11 Mar 2007, Yukihiro M. wrote:

          matz.

hi matz - just out of curiosity, what’s your reason for using firefox?

-a

20

On Mar 11, 3:35 pm, Yukihiro M. [email protected] wrote:

Could you add Iceweasel for poor debian users? My user-agent line is:

Yes of course!