diff --git a/README.md b/README.md
index 94e32dfaf..c76d78b09 100644
--- a/README.md
+++ b/README.md
@@ -18,13 +18,11 @@ A high performance, open source Python code library for economics
 
 ## Installation
 
-Before installing `quantecon` we recommend you install the [Anaconda](https://www.anaconda.com/download/) Python distribution, which includes a full suite of scientific python tools.
-
-Next you can install quantecon by opening a terminal prompt and typing
+Install QuantEcon.py from PyPI:
 
     pip install quantecon
 
-or using conda-forge by typing
+If you use conda, install from conda-forge (Anaconda Distribution is not required):
 
     conda install -c conda-forge quantecon
 
diff --git a/docs/source/contributing.rst b/docs/source/contributing.rst
index 4955f0989..23da4aa94 100644
--- a/docs/source/contributing.rst
+++ b/docs/source/contributing.rst
@@ -108,6 +108,13 @@ reference example):
   the release until a campaign is finished — release as soon as the milestone's library fixes have
   landed, and treat the milestone as the release checklist.
 
+
+When cutting a release, update ``CITATION.cff`` so the top-level
+``version`` and ``date-released`` fields match the tag being published.
+Citation exporters use those fields for the software snapshot; the
+``preferred-citation`` block remains the JOSS article and should not be
+edited as part of a routine release.
+
 Further questions
 -----------------