Merge pull request scala#161 from scala/SethTisue-patch-1

various readme tweaks

Author: ashawley

README.md

@@ -6,18 +6,21 @@ scala-xml
 [![Gitter](https://badges.gitter.im/Join+Chat.svg)](https://gitter.im/scala/scala-xml)
 =========
 
-The standard Scala XML library. Please file issues here instead of over at issues.scala-lang.org.
+The standard Scala XML library. Please file XML issues here, not at https://github.com/scala/bug/issues.
 
 Since Scala 2.11, this library is a separate jar that can be omitted from Scala projects that do not use XML.
-If you are cross-building a project that uses scala-xml with both Scala 2.10 and later Scala versions, take a look [this example](https://github.com/scala/scala-module-dependency-sample).
 
-The compiler was decoupled from this particular implementation using the same approach as for comprehensions (XML syntax is desugared into a set of method calls, which unfortunately is only defined by the [implementation](https://github.com/scala/scala/blob/2.11.x/src/compiler/scala/tools/nsc/ast/parser/SymbolicXMLBuilder.scala)). Alternative implementations are welcome!
+The decoupling works because the compiler desugars XML literals in Scala source code into a set of method calls. Alternative implementations of these calls are welcome! (The calls are unfortunately only defined by the [implementation](https://github.com/scala/scala/blob/2.11.x/src/compiler/scala/tools/nsc/ast/parser/SymbolicXMLBuilder.scala).)
 
 API documentation is available [here](http://www.scala-lang.org/api/current/scala-xml/scala/xml/index.html).
 
+## Cross-building with 2.10
+
+If you are cross-building a project that uses scala-xml with both Scala 2.10 and later Scala versions, take a look at [this example](https://github.com/scala/scala-module-dependency-sample).
+
 ## Maintenance status
 
-This library is community-maintained. The lead maintainers are [@biswanaths](https://github.com/biswanaths) and [@aaron_s_hawley](https://github.com/ashawley).
+This library is community-maintained. The lead maintainers are [@aaron_s_hawley](https://github.com/ashawley) and [@biswanaths](https://github.com/biswanaths).
 
 ## Security best practices