diff --git a/CONTRIBUTING.md b/contributing.md
similarity index 100%
rename from CONTRIBUTING.md
rename to contributing.md
diff --git a/CONTRIBUTORS.md b/contributors.md
similarity index 100%
rename from CONTRIBUTORS.md
rename to contributors.md
diff --git a/DESIGN.md b/design.md
similarity index 100%
rename from DESIGN.md
rename to design.md
diff --git a/LICENSE.txt b/license.txt
similarity index 100%
rename from LICENSE.txt
rename to license.txt
diff --git a/README.md b/readme.md
similarity index 100%
rename from README.md
rename to readme.md
diff --git a/src/rendering.rs b/src/rendering.rs
index 1a78eec..4dcd166 100644
--- a/src/rendering.rs
+++ b/src/rendering.rs
@@ -28,7 +28,11 @@ pub fn render_markdown_for_fts(src: &str) -> String {
 
     for event in p {
         match event {
+            // As far as I understand this is a basic
+            // sanitizing to prevent HTML from
+            // appearing  in page.
             Text(text) => buf.push_str(&text.replace(is_html_special, " ")),
+            // Footnote links maybe?
             End(Tag::Link(uri, _title)) => {
                 buf.push_str(" (");
                 buf.push_str(&uri.replace(is_html_special, " "));