From e18e114919bf210d65a1ee3234f0943daab358ec Mon Sep 17 00:00:00 2001
From: Elijah Newren <newren@gmail.com>
Date: Mon, 25 Nov 2019 06:30:29 -0800
Subject: [PATCH] WIP

---
 Documentation/Contributing.md |  7 ++++---
 INSTALL => INSTALL.md         | 32 +++++++++++++++++++++++++++++++-
 README.md                     |  6 +++---
 3 files changed, 38 insertions(+), 7 deletions(-)
 rename INSTALL => INSTALL.md (56%)

diff --git a/Documentation/Contributing.md b/Documentation/Contributing.md
index fdf09e7..43e2771 100644
--- a/Documentation/Contributing.md
+++ b/Documentation/Contributing.md
@@ -61,6 +61,7 @@ git.git](https://git.kernel.org/pub/scm/git/git.git/tree/Documentation/Submittin
       broadly in the code base multiple times; but it's just a bad
       idea to use an abstraction that doesn't fit the data.
     * I generally like [PEP
-      8](https://www.python.org/dev/peps/pep-0008/), but have used
-      two-space indents for years anyway -- and expect contributions
-      to do the same.
+      8](https://www.python.org/dev/peps/pep-0008/), but used
+      two-space indents for years before learning of it and have just
+      continued that habit.  For consistency, contributions should also
+      use two-space indents and otherwise generally follow PEP 8.
diff --git a/INSTALL b/INSTALL.md
similarity index 56%
rename from INSTALL
rename to INSTALL.md
index f9f9e63..ca93f91 100644
--- a/INSTALL
+++ b/INSTALL.md
@@ -1,3 +1,5 @@
+# What/why/where to install things
+
 filter-repo only consists of a few files that need to be installed:
 
   * git-filter-repo
@@ -28,6 +30,8 @@ filter-repo only consists of a few files that need to be installed:
     version of the same page is provided for those who prefer it.  Place it
     where ever you like; I have no idea where such a thing should go.
 
+# Installation via Makefile
+
 Installing should be doable by hand, but a Makefile is provided for those
 that prefer it.  However, usage of the Makefile really requires overridding
 at least a couple of the directories with sane values, e.g.
@@ -36,4 +40,30 @@ at least a couple of the directories with sane values, e.g.
 
 Also, the Makefile will not edit the shebang line (the first line) of
 git-filter-repo if your python executable is not named "python3";
-you'll still need to do that yourself.
\ No newline at end of file
+you'll still need to do that yourself.
+
+# Installation via [pip](https://pip.pypa.io/)
+
+Coming soon; see [PR #16](https://github.com/newren/git-filter-repo/pull/16).
+
+# Installation via Package Manager
+
+There are [package
+managers](https://alternativeto.net/software/yellowdog-updater-modified/?license=opensource)
+for most operating systems; from
+[dnf](https://github.com/rpm-software-management/dnf) or
+[yum](http://yum.baseurl.org/) or
+[apt-get](https://www.debian.org/doc/manuals/debian-reference/ch02.en.html)
+or whatever for Linux, to [brew](https://brew.sh/) for Mac OS X, to
+[scoop](https://scoop.sh/) for Windows.  Nearly any of these tools
+will reduce the installation instructions down to
+
+    $ PACKAGE_TOOL install git-filter-repo
+
+I have no interest in tracking all these pre-built packages (nor
+whether those who packaged git-filter-repo have made modifications or
+left parts of it out), but apparently https://repology.org is willing
+to track who has packaged it.  So, using repology's packaging status
+link, the following package managers have packaged git-filter-repo:
+
+[![Packaging status](https://repology.org/badge/vertical-allrepos/git-filter-repo.svg)](https://repology.org/project/git-filter-repo/versions)
diff --git a/README.md b/README.md
index 2ecea07..2ee98ac 100644
--- a/README.md
+++ b/README.md
@@ -43,11 +43,11 @@ filter-repo requires:
 git-filter-repo is a single-file python script, which was done to make
 installation for basic use trivial: just copy it into your $PATH.
 
-See [INSTALL](INSTALL) for things beyond basic usage or special cases.
-The more involved instructions are needed if you
+See [INSTALL.md](INSTALL.md) for things beyond basic usage or special
+cases.  The more involved instructions are needed if you
 
   * are working with a python3 executable named something other than "python3"
-  * want to install documentation
+  * want to install documentation (beyond the builtin docs shown with -h)
   * want to run some of the [contrib](contrib/filter-repo-demos/) examples
   * want to create your own python filtering scripts using filter-repo as a
     module/library