Sort sections

Author: termoshtt

README.md

@@ -1,16 +1,32 @@
 ndarray-linalg
 ===============
+[![CircleCI](https://circleci.com/gh/termoshtt/ndarray-linalg.svg?style=shield)](https://circleci.com/gh/termoshtt/ndarray-linalg)
 [![Crate](http://meritbadge.herokuapp.com/ndarray-linalg)](https://crates.io/crates/ndarray-linalg)
 [![docs.rs](https://docs.rs/ndarray-linalg/badge.svg)](https://docs.rs/ndarray-linalg)
-[![CircleCI](https://circleci.com/gh/termoshtt/ndarray-linalg.svg?style=shield)](https://circleci.com/gh/termoshtt/ndarray-linalg)
-[![Gitter chat](https://badges.gitter.im/termoshtt-scirust/ndarray-linalg.png)](https://gitter.im/termoshtt-scirust/ndarray-linalg)
 
-Linear algebra package for Rust with [rust-ndarray](https://github.com/bluss/rust-ndarray).
+Linear algebra package for Rust with [ndarray](https://github.com/bluss/ndarray) based on external LAPACK implementations.
+
+Examples
+---------
+See [examples](https://github.com/termoshtt/ndarray-linalg/tree/master/examples) directory.
+
+Note that to run an example, you must specify the desired backend (as described below).
+For example, you can run the the `solve` example with the OpenBLAS backend like this:
+
+```sh
+cargo run --example solve --features=openblas
+```
+
+and test of ndarray-linalg:
 
-LAPACKE Backend
-----------------
+```sh
+cargo test --features=openblas
+```
 
-Currently three LAPACKE implementations are supported and tested:
+BLAS/LAPACK Backend
+-------------------
+
+Three BLAS/LAPACK implementations are supported:
 
 - [OpenBLAS](https://github.com/cmr/openblas-src)
   - needs `gfortran` (or other Fortran compiler)
@@ -19,9 +35,6 @@ Currently three LAPACKE implementations are supported and tested:
 - [Intel MKL](https://github.com/termoshtt/rust-intel-mkl) (non-free license, see the linked page)
   - needs `curl`
 
-There are two ways to link LAPACKE backend:
-
-### backend features (recommended)
 There are three features corresponding to the backend implementations (`openblas` / `netlib` / `intel-mkl`):
 
 ```toml
@@ -30,7 +43,16 @@ ndarray = "0.12"
 ndarray-linalg = { version = "0.10", features = ["openblas"] }
 ```
 
-### link backend crate manually
+### For librarian
+If you creating a library depending on this crate, we encourage you not to link any backend:
+
+```toml
+[dependencies]
+ndarray = "0.12"
+ndarray-linalg = "0.10"
+```
+
+### Link backend crate manually
 For the sake of linking flexibility, you can provide LAPACKE implementation (as an `extern crate`) yourself.
 You should link a LAPACKE implementation to a final crate (like binary executable or dylib) only, not to a Rust library.
 
@@ -49,35 +71,3 @@ extern crate ndarray;
 extern crate ndarray_linalg;
 extern crate openblas_src; // or another backend of your choice
 ```
-
-### For librarian
-If you creating a library depending on this crate, we encourage you not to link any backend for flexibility:
-
-```toml
-[dependencies]
-ndarray = "0.12"
-ndarray-linalg = { version = "0.10", default-features = false }
-```
-
-However, if you hope simplicity instead of the flexibility, you can link your favorite backend in the way described above.
-
-### Tests and Examples
-
-To run tests or examples for `ndarray-linalg`, you must specify the desired
-backend. For example, you can run the tests with the OpenBLAS backend like
-this:
-
-```sh
-cargo test --features=openblas
-```
-
-Examples
----------
-See [examples](https://github.com/termoshtt/ndarray-linalg/tree/master/examples) directory.
-
-Note that to run an example, you must specify the desired backend. For example,
-you can run the the `solve` example with the OpenBLAS backend like this:
-
-```sh
-cargo run --example solve --features=openblas
-```