diff --git a/pkg/textparse/README.md b/pkg/textparse/README.md
new file mode 100644
index 000000000..697966f09
--- /dev/null
+++ b/pkg/textparse/README.md
@@ -0,0 +1,6 @@
+# Making changes to textparse lexers
+In the rare case that you need to update the textparse lexers, edit promlex.l or openmetricslex.l and then run the following command: 
+`golex -o=promlex.l.go promlex.l`
+
+Note that you need golex installed: 
+`go get -u modernc.org/golex`
\ No newline at end of file