diff --git a/ruby-on-rails/README.rdoc b/ruby-on-rails/--README.rdoc
similarity index 100%
rename from ruby-on-rails/README.rdoc
rename to ruby-on-rails/--README.rdoc
diff --git a/ruby-on-rails/README.md b/ruby-on-rails/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..9c81d6f8e015944df1db89119f4c9f02b18e442d
--- /dev/null
+++ b/ruby-on-rails/README.md
@@ -0,0 +1,66 @@
+== README
+
+Ez egy teljes project, egy m�k�d� rails alkalmaz�s ahhoz, hogy legyen min fejleszteni tesztelni a rails klienst. Saj�t alkalmaz�s k�sz�t�s�hez k�vesd a lentebbi utas�t�sokat.
+
+
+== Haszn�lat
+
+El�sz�r is kell devise, omniauth �s omniauth-oauth2 gem a Gemfileba.
+
+Nagyj�b�l ezt a tutorialt lehet k�vetni: https://github.com/plataformatec/devise/wiki/OmniAuth:-Overview
+
+Deviseban gener�lunk saj�t usert:
+```
+rails generate devise:install
+rails generate devise User
+```
+(User helyett b�rmi lehet)
+
+Ezut�n kieg�sz�tj�k ezt a modellt �s migr�lunk is:
+```
+rails g migration AddColumnsToUsers provider uid
+rake db:migrate
+```
+config/initializers/devise.rb:
+```ruby
+config.omniauth :sch, 'APP_ID','APP_SECRET',scope: 'basic mail'
+```
+ha m�r abban a mapp�ban vagyunk, ebb�l a projectb�l a config/initializers/sch.rb -t m�soljuk is �t
+
+config/roots.rb:
+```ruby
+devise_for :users, :controllers => { :omniauth_callbacks => "users/omniauth_callbacks" }
+```
+(Ha fent nem User-t hoztunk l�tre akkor ezt is �rtelemszer�en m�dos�tani kell!)
+
+app/controllers/users/omniauth_callbacks_controller.rb:
+legegyszer�bb m�solni innen �gy ahogy van, �rdekl�d�k elolvashatj�k az Overview-s linket
+
+app/models/user.rb:
+L�nyeg�ben m�solhat�, nincs benne nagy var�zslat, a k�t f�ggv�ny ami benne van az kell ahhoz hogy m�k�dj�n, ugyancsak a fentebbi linkb�l meg�rthet�.
+
+Ezzel elvileg a keret fel van �p�tve. �rdemes m�g egy olyan view-al rendelkezni amin le is lehet tesztelni a dolgot:
+```ruby
+<% if user_signed_in? %>
+	<%= current_user.email%>
+	<br>
+	<%= link_to('Logout', destroy_user_session_path, :method=>'delete') %>
+<% else %>
+	<%= link_to "Sign in with SCH", user_omniauth_authorize_path(:sch) %>
+<% end %>
+```
+Ha csak bejelentkez�s ut�n akarsz tartalmat mutatni, akkor config/roots.rb:
+```ruby
+devise_scope :user do
+	authenticated :user do
+		root 'base#index2', as: :authenticated_root
+	end
+
+	unauthenticated do
+		root 'base#index', as: :unauthenticated_root
+	end
+end
+```
+
+
+