Re: [Rails-core] Re: Why don't we redesign our website and docs rubyonrails.org like laravel.com

2019-11-01 Thread Colin Ross
I think it might also be important to note that the guides don't intend to 
be exhaustive reference or a cookbook, but a high level guide to what the 
framework provides for customization and where to look next.

The version is the current stable version as a default with previous 
versions still available via the path, 
eg https://guides.rubyonrails.org/v4.2/

On Friday, November 1, 2019 at 5:52:52 AM UTC-7, Diego Toral wrote:
>
> I agree and think guides need some love.
>
> I think Rails guides is confusing, specially for newcomers. I remember 
> struggling to understand it on my first days of Rails. Ideally, the guides 
> should be easy to use and friendly to newcomers, searchable (I currently 
> use google) and show the Rails version somewhere.
> On 30 Oct 2019 09:29 -0300, Agus Syahputra  >, wrote:
>
> Sorry I can not edit my previous message. This is the git books link: 
> https://docs.gitbook.com as the sample of the structure of the menu. I 
> just think the menu is easier to be used.
>
> --
> You received this message because you are subscribed to the Google Groups 
> "Ruby on Rails: Core" group.
> To unsubscribe from this group and stop receiving emails from it, send an 
> email to rubyonra...@googlegroups.com .
> To view this discussion on the web visit 
> https://groups.google.com/d/msgid/rubyonrails-core/3ae52b3a-5137-4b03-b1db-004d045208b7%40googlegroups.com
>  
> 
> .
>
>

-- 
You received this message because you are subscribed to the Google Groups "Ruby 
on Rails: Core" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to rubyonrails-core+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/rubyonrails-core/45156fbf-73e6-4050-92c9-4df566fcc74c%40googlegroups.com.


Re: [Rails-core] Re: Why don't we redesign our website and docs rubyonrails.org like laravel.com

2019-11-01 Thread Xavier Noria
On Fri, Nov 1, 2019 at 1:52 PM Diego Toral  wrote:

I think Rails guides is confusing, specially for newcomers. I remember
> struggling to understand it on my first days of Rails.
>

Can you elaborate? What was difficult to understand for you?


> searchable
>

Patches welcome. Constraints are:

1) The website is static.

2) Open source search engine.

Furthermore, if the solution is provided by a company, no logos or
advertisements of any kind.

-- 
You received this message because you are subscribed to the Google Groups "Ruby 
on Rails: Core" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to rubyonrails-core+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/rubyonrails-core/CAM%3DYcdhdXVbEKuRcfuYXvqEL%2B0LWt0aU9kCHfFFs5k0-tJeB8A%40mail.gmail.com.


Re: [Rails-core] Re: Why don't we redesign our website and docs rubyonrails.org like laravel.com

2019-11-01 Thread Diego Toral
I agree and think guides need some love.

I think Rails guides is confusing, specially for newcomers. I remember 
struggling to understand it on my first days of Rails. Ideally, the guides 
should be easy to use and friendly to newcomers, searchable (I currently use 
google) and show the Rails version somewhere.
On 30 Oct 2019 09:29 -0300, Agus Syahputra , wrote:
> Sorry I can not edit my previous message. This is the git books link: 
> https://docs.gitbook.com as the sample of the structure of the menu. I just 
> think the menu is easier to be used.
> --
> You received this message because you are subscribed to the Google Groups 
> "Ruby on Rails: Core" group.
> To unsubscribe from this group and stop receiving emails from it, send an 
> email to rubyonrails-core+unsubscr...@googlegroups.com.
> To view this discussion on the web visit 
> https://groups.google.com/d/msgid/rubyonrails-core/3ae52b3a-5137-4b03-b1db-004d045208b7%40googlegroups.com.

-- 
You received this message because you are subscribed to the Google Groups "Ruby 
on Rails: Core" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to rubyonrails-core+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/rubyonrails-core/aa0dde30-1ac6-4f5d-a882-c38630debc39%40Spark.


Re: [Rails-core] Re: Why don't we redesign our website and docs rubyonrails.org like laravel.com

2019-10-30 Thread Xavier Noria
On Wed, Oct 30, 2019 at 1:18 PM Agus Syahputra 
wrote:

I don't know, I just want that rubyonrails.org need cool/modern new look.
> Maybe like https://reactjs.org
>

The website looks modern to us, an old design would something more like this
.

And also for the docs, maybe we have to re-structure the menus so it's
> easier to navigate the guides. Make it simpler like https://reactjs.org or git
> books.
>

A matter of opinion too. We have a guides selector, and a sidebar for
sections. I mean, you can always polish and iterate things, and perhaps you
personally would prefer another navigation UI, but the current layout is
fine for us.

And also for the guides, I think the guides are too many words, maybe we
> can make it shorter.
>

No way, we need *more* words :).

-- 
You received this message because you are subscribed to the Google Groups "Ruby 
on Rails: Core" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to rubyonrails-core+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/rubyonrails-core/CAM%3DYcdjBEko%2B67WpLoKjWuNjN5tp48cKfaza25Qufxv%3DtMsSUg%40mail.gmail.com.