From 9f51d8a4eabf976ac02e0719907b1b07cb543c45 Mon Sep 17 00:00:00 2001
From: Kartik Mistry <kartik.mistry@gmail.com>
Date: Thu, 22 Aug 2013 11:51:03 +0530
Subject: [PATCH] README Updates

1. Updated instruction to enable ULS in LocalSettings.php
2. Wrapped text to 80 chars.
3. Removed unused Change Log section.
4. Added short information about ULS.
5. Updated 'For developers' information.

Change-Id: Iebc8b923cbfcbb8f39e45e12d1e2e5c835076dd2
---
 README | 42 +++++++++++++++++++++++++++++++-----------
 1 file changed, 31 insertions(+), 11 deletions(-)

diff --git a/README b/README
index 371d4c1a..b8e1d9f2 100644
--- a/README
+++ b/README
@@ -1,22 +1,42 @@
-== Copying ==
+== Universal Language Selector ==
+The Universal Language Selector extension (ULS) provides a flexible way to
+configure and deliver language settings like interface language, fonts, and
+input methods (keyboard mappings). This will allow users to type text in
+different languages not directly supported by their keyboard, read content in a
+script for which fonts are not available locally, or customise the language in
+which menus are displayed.
 
-In short: You may use any Project Milkshake product, including the Universal
-Language Selector, under the terms of either the MIT License or the GNU General
-Public License (GPL) Version 2 or later.
+For more information see:
+ https://www.mediawiki.org/wiki/Universal_Language_Selector
+
+== Copying ==
+You may use any Project Milkshake product, including the Universal Language
+Selector, under the terms of either the MIT License or the GNU General Public
+License (GPL) Version 2 or later.
 
 See GPL-LICENSE and MIT-LICENSE for details.
 
 == Installation ==
-For a very, very quick start add the following to LocalSettings.php:
+For a very, very quick start add the following lines to LocalSettings.php of
+your MediaWiki setup:
 
-include("$IP/extensions/UniversalLanguageSelector/UniversalLanguageSelector.php");
+require_once "$IP/extensions/UniversalLanguageSelector/UniversalLanguageSelector.php";
+
+By default, ULS will appear at personal toolbar position. If you want ULS at
+interlanguage position, add the following line:
+
+$wgULSPosition = 'interlanguage';
 
 == For Developers ==
-The MediaWiki Universal Language Selector project uses jquery.uls(https://github.com/wikimedia/jquery.uls).
-Its development is at wikimedia github account. So any fixes to lib/jquery.uls should happen at github. 
-Follow the build instructions of jquery.uls to create jquery.uls.js.
+The MediaWiki Universal Language Selector project uses jquery.uls:
+ https://github.com/wikimedia/jquery.uls
 
-More documenation is at
+Its development is at Wikimedia Github account. Any fixes to lib/ should happen
+at Github. Follow the build instructions of jquery.uls to create jquery.uls.js.
+
+More documenation is at:
  https://www.mediawiki.org/wiki/Extension:UniversalLanguageSelector
 
-== Change log ==
+For reporting bugs, use 'UniversalLanguageSelector' component under
+'MediaWiki extensions' product at:
+ https://bugzilla.wikimedia.org