updated contributor-guide to add github links & updated milagro-intro - in response to issues 19 & 20 rasied by sebbASF
diff --git a/docs/contributor-guide.md b/docs/contributor-guide.md
index 69d5015..9e4d233 100644
--- a/docs/contributor-guide.md
+++ b/docs/contributor-guide.md
@@ -5,10 +5,25 @@
---
# Become a contributor
+## Apache Milgaro Mailing List
-<p>Keeping with our spartan theme, for now, it's best to send an email to <a href="mailto:dev-subscribe@milagro.apache.org?Subject=Subscribe" target="_top">dev-subscribe @ milagro.apache.org</a> to join our mailing list.</p>
+If you'd like to subscribe to our developer's mailing list, please send an email to:
-More information will be available here shortly.
+<a href="mailto:dev-subscribe@milagro.apache.org?Subject=Subscribe" target="_top">dev-subscribe @ milagro.apache.org</a>
+
+## Issues
+
+Our current GitHub repositories are:
+
+* https://github.com/apache/incubator-milagro - used to build this website
+* https://github.com/apache/incubator-milagro-crypto-c - standards compliant cryptographic library written in C
+* https://github.com/apache/incubator-milagro-crypto-js - standards compliant cryptographic library written in JavaScript
+* https://github.com/apache/incubator-milagro-crypto-rust - standards compliant cryptographic library written in Rust
+* https://github.com/apache/incubator-milagro-dta - Milagro Decentralized Trust Authority (D-TA) - a collaborative key management server
+* https://github.com/apache/incubator-milagro-mfa-server - the Milagro Multi-Factor Authentication server (soon to be updated!)
+
+Please use the "Issues" tab on these repos to report any bugs or feature requests.
+
<!--
Supported admonition types are: caution, note, important, tip, warning.
diff --git a/docs/milagro-intro.md b/docs/milagro-intro.md
index c9fba87..fdab6f6 100644
--- a/docs/milagro-intro.md
+++ b/docs/milagro-intro.md
@@ -16,13 +16,13 @@
Pairings map pairs of points on an elliptic curve into the multiplicative group of a finite field. Their unique properties have enabled many new cryptographic protocols that had not previously been feasible.
-[Pairing-Based Cryptography (PBC)](https://en.wikipedia.org/wiki/Pairing-based_cryptography) is emerging as a solution to complex problems that proved intractable to the standard mathematics of Public-Key Cryptography such as Identity-Based Encryption, whereby the identity of a client can be used as their public key.
+[Pairing-Based Cryptography (PBC)](https://en.wikipedia.org/wiki/Pairing-based_cryptography) is emerging as a solution to complex problems that proved intractable to the standard mathematics of Public-Key Cryptography such as Identity-Based Encryption (IBE), whereby the identity of a client can be used as their public key.
-In certain use cases, this removes the need for a PKI infrastructure eliminates the root key 'single point of compromise' weakness, as the main reason to issue certificates is used to bind a public / private key pair to an identity.
+In certain use cases, this removes the need for a PKI infrastructure as the main reason to issue certificates is to bind a public / private key pair to an identity - a function not required when using IBE.
Removing the certificate management burden enables the identity management and key lifecycle to take place within the decentralized cryptosystem itself.
-As a result, Milagro's decentralized cryptosystem design goals seek to deliver products that are easier to scale and manage that traditional PKI, and are a seamless fit for today's decentralized networks and distributed systems.
+As a result, Milagro's decentralized cryptosystem design goals seek to deliver products that are easier to scale and manage than traditional PKI, eliminate root key 'single point of compromise' weaknesses and are a seamless fit for today's decentralized networks and distributed systems.
## Pairings Go Mainstream