2024-03-20
- Rails Foundation
(from Ruby on Rails)
When Rails 7.0 landed in December 2021, it came with a fresh new homepage and a new boot screen. The design of the guides, however, has remained largely untouched since 2009 - a point which hasn’t gone unnoticed (we heard your feedback).
When Rails 7.0 landed in December 2021, it came with a fresh new homepage and a new boot screen. The design of the guides, however, has remained largely untouched since 2009 - a point which hasn’t gone unnoticed (we heard your feedback).
With all of the work right now going into removing complexity from the Rails framework and making the documentation consistent, clear, and up-to-date, it was time to tackle the design of the guides and make them equally modern, simple, and fresh.
We worked with UX designer John Athayde to take the look and feel of the homepage and transfer that over to the Rails Guide to make it clean, sleek, and up-to-date.
The layout will remain the same, but from today you will see the following changes reflected in the Edge Guides:
Cleaner, less busy design.
Fonts, color scheme, and logo more consistent with the home page.
Updated iconography.
Simplified navigation.
Sticky ‘Chapter’ navbar when scrolling.
Before & After
For now, this refresh is still a work in progress, so it is only reflected in the Edge Guides while we make the final adjustments. Once we are happy with it, we will update the guides for stable Rails 7 versions. This design will then render for all new guides from the next release onwards.
Feedback
If you find a bug or wish to submit a suggestion*, please open a discussion on GitHub, and feel free to tag Amanda for visibility.
Hope you like the changes, and we look forward to your feedback!
(* A search bar has already been suggested and we will look into options with the Core team.)
[Technology]
🌎 https://rubyonrails.org/2024/3/20/rails-guides-get-a-facelift
[🧠] [v2] article_embedding_description: {:llm_project_id=>"Unavailable", :llm_dimensions=>nil, :article_size=>2968, :llm_embeddings_model_name=>"textembedding-gecko"}
[🧠] [v1/3] title_embedding_description: {:ricc_notes=>"[embed-v3] Fixed on 9oct24. Only seems incompatible at first glance with embed v1.", :llm_project_id=>"unavailable possibly not using Vertex", :llm_dimensions=>nil, :article_size=>2968, :poly_field=>"title", :llm_embeddings_model_name=>"textembedding-gecko"}
[🧠] [v1/3] summary_embedding_description: {:ricc_notes=>"[embed-v3] Fixed on 9oct24. Only seems incompatible at first glance with embed v1.", :llm_project_id=>"unavailable possibly not using Vertex", :llm_dimensions=>nil, :article_size=>2968, :poly_field=>"summary", :llm_embeddings_model_name=>"textembedding-gecko"}
[🧠] As per bug https://github.com/palladius/gemini-news-crawler/issues/4 we can state this article belongs to titile/summary version: v3 (very few articles updated on 9oct24)
{"id"=>4269,
"title"=>"Rails Guides get a facelift",
"summary"=>"When Rails 7.0 landed in December 2021, it came with a fresh new homepage and a new boot screen. The design of the guides, however, has remained largely untouched since 2009 - a point which hasn’t gone unnoticed (we heard your feedback).",
"content"=>"When Rails 7.0 landed in December 2021, it came with a fresh new homepage and a new boot screen. The design of the guides, however, has remained largely untouched since 2009 - a point which hasn’t gone unnoticed (we heard your feedback).
\n\nWith all of the work right now going into removing complexity from the Rails framework and making the documentation consistent, clear, and up-to-date, it was time to tackle the design of the guides and make them equally modern, simple, and fresh.
\n\nWe worked with UX designer John Athayde to take the look and feel of the homepage and transfer that over to the Rails Guide to make it clean, sleek, and up-to-date.
\n\nThe layout will remain the same, but from today you will see the following changes reflected in the Edge Guides:
\n\n\n - Cleaner, less busy design.
\n - Fonts, color scheme, and logo more consistent with the home page.
\n - Updated iconography.
\n - Simplified navigation.
\n - Sticky ‘Chapter’ navbar when scrolling.
\n
\n\nBefore & After
\n\n![](\"/assets/images/guide-update)
\n\n
\n\n
\n\nFor now, this refresh is still a work in progress, so it is only reflected in the Edge Guides while we make the final adjustments. Once we are happy with it, we will update the guides for stable Rails 7 versions. This design will then render for all new guides from the next release onwards.
\n\nFeedback
\n\nIf you find a bug or wish to submit a suggestion*, please open a discussion on GitHub, and feel free to tag Amanda for visibility.
\n\nHope you like the changes, and we look forward to your feedback!
\n\n(* A search bar has already been suggested and we will look into options with the Core team.)
",
"author"=>"Rails Foundation",
"link"=>"https://rubyonrails.org/2024/3/20/rails-guides-get-a-facelift",
"published_date"=>Wed, 20 Mar 2024 00:00:00.000000000 UTC +00:00,
"image_url"=>nil,
"feed_url"=>"https://rubyonrails.org/2024/3/20/rails-guides-get-a-facelift",
"language"=>nil,
"active"=>true,
"ricc_source"=>"feedjira::v1",
"created_at"=>Mon, 01 Apr 2024 20:13:50.085292000 UTC +00:00,
"updated_at"=>Mon, 21 Oct 2024 18:04:05.967946000 UTC +00:00,
"newspaper"=>"Ruby on Rails",
"macro_region"=>"Technology"}