Add InCommon information to the top of README.md

README.md

@@ -1,3 +1,26 @@
+# InCommon Federation Metadata Toolchain
+
+This repository contains some of the tooling used by the
+[InCommon Federation](https://www.incommon.org) to:
+
+* Import metadata from the [eduGAIN](https://edugain.org) interfederation
+  service, including filtering and transforming that metadata to meet
+  InCommon's needs.
+
+* Generate per-entity metadata for publication through the Metadata Query
+  protocol.
+
+This tooling draws heavily on that used by the
+[UK federation](https://www.ukfederation.org.uk) as published
+[on GitHub](https://github.com/ukf/ukf-meta). The `upstream` branch of this
+repository mirrors the `master` branch from that repository, and useful
+upstream changes are often merged in here.
+
+The remainder of this file is the original `README.md` from the upstream
+repository.
+
+----
+
 # UK federation Metadata Toolchain
 
 This is the metadata repository and main toolset for the [UK Access Management Federation for Education and Research](http://ukfederation.org.uk) ("the UK federation").