diff --git a/rhodecode/i18n/how_to b/rhodecode/i18n/how_to
--- a/rhodecode/i18n/how_to
+++ b/rhodecode/i18n/how_to
@@ -1,15 +1,28 @@
-#goto pylons folder app (the on holding .ini files)
+##########################
+# to create new language #
+##########################
 
-# to create new 
+#this needs to be done on source codes, preferable default/stable branches
+ 
 python setup.py extract_messages -> get messages from project
-python setup.py init_catalog -l pl -> create a language directory
-edit the new po file with poedit
+python setup.py init_catalog -l pl -> create a language directory for <pl> lang
+edit the new po file with poedit or any other editor
 python setup.py compile_catalog -> create translation files
-#done 
- 
- # to update
+
+############# 
+# to update #
+#############
+
 python setup.py extract_messages -> get messages from project
 python setup.py update_catalog -> to update the translations
 edit the new updated po file with poedit
 python setup.py compile_catalog -> create translation files
-#done
\ No newline at end of file
+
+
+###################
+# change language #
+###################
+
+`lang=en`
+
+in the .ini file
\ No newline at end of file