X-Git-Url: https://git.r.bdr.sh/rbdr/lyricli/blobdiff_plain/22172f7d09afee10de0329160e0003e0aa9ff7ed..c53df649c817f770ae1750bb6d11113e0bcd2b18:/README.md

diff --git a/README.md b/README.md
index d3ad9e9..6d6046a 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,7 @@ A command line tool to show the lyrics of your current song.
 
 ## Usage
 
-Lyricli can be invoked with the command `lrc`. It can be invoked without
-arguments, with an artist and song or with a special command:
+Lyricli can be invoked with the command `lrc`.
 
 ```
 $ lrc [-t]
@@ -26,20 +25,24 @@ song and artist names before the lyrics.
 
 ### Commands
 
-In order to configure
+In order to configure sources, lyricli provides a few commands:
 
 * `lrc -l` or `lrc --list-sources` lists the available sources. Enabled
   sourcess will have a `*`
-* `lrc -e` or `lrc --enable <source>` enables a source
-* `lrc -d` or `lrc --disable <source>` disables a source
-* `lrc -r` or `lrc --reset-source <source>` resets the configuration for
-  a source and disables it.
+* `lrc -e` or `lrc --enable-source <source>` enables a source
+* `lrc -d` or `lrc --disable-source <source>` disables a source without
+  resetting its configuration.
+* `lrc -r` or `lrc --reset-source <source>` resets the configuration
+  for a source and disables it.
+
+And you can print the help or the version:
+
 * `lrc -v` or `lrc --version` prints the version
 * `lrc -h` or `lrc --help` display built-in help
 
 ## Building
 
-The build has only been tested on OSX using Swift 3.1. Building defaults
+The build has only been tested on OSX using Swift 5.8 Building defaults
 to the debug configuration.
 
 ```
@@ -63,6 +66,12 @@ This can be done by overriding the `install_path` variable
 make install install_path=/opt/bin
 ```
 
+## Linting and Generating Documentation
+
+We use [swiftlint][swiftlint] to lint, and `make lint` to run it.
+We use [jazzy][jazzy] and [SourceKitten][sourcekitten] to document, and
+`make document` to generate it.
+
 ## Running tests
 
 No tests at the moment 😬... but the makefile is mapped to run the swift
@@ -72,4 +81,6 @@ tests.
 make test
 ```
 
-[![Build Status](https://travis-ci.org/lyricli-app/lyricli.svg?branch=master)](https://travis-ci.org/lyricli-app/lyricli)
+[swiftlint]: https://github.com/realm/SwiftLint
+[jazzy]: https://github.com/realm/jazzy
+[sourcekitten]: https://github.com/jpsim/SourceKitten