Add docstrings and README for scipy clustering

Author: bryanwweber

python-scipy-cluster-optimize/README.md

@@ -0,0 +1,13 @@
+# Scientific Python: Using SciPy for Optimization
+
+The code in this folder is associated with the Real Python tutorial [_Scientific Python: Using SciPy for Optimization_](https://realpython.com/python-scipy-cluster-optimize/).
+
+The dataset for the SMS spam clustering example, contained in the file SMSSpamCollection in this folder, is discussed in following articles:
+
+Almeida, T.A., Gómez Hidalgo, J.M., Yamakami, A. Contributions to the Study of SMS Spam Filtering: New Collection and Results. Proceedings of the 2011 ACM Symposium on Document Engineering (DOCENG'11), Mountain View, CA, USA, 2011\. [preprint](http://www.dt.fee.unicamp.br/~tiago/smsspamcollection/doceng11.pdf)
+
+Gómez Hidalgo, J.M., Almeida, T.A., Yamakami, A. On the Validity of a New SMS Spam Collection. Proceedings of the 11th IEEE International Conference on Machine Learning and Applications (ICMLA'12), Boca Raton, FL, USA, 2012\. [preprint](http://www.dt.fee.unicamp.br/~tiago/smsspamcollection/icmla12.pdf)
+
+Almeida, T.A., Gómez Hidalgo, J.M., Silva, T.P. Towards SMS Spam Filtering: Results under a New Dataset. International Journal of Information Security Science (IJISS), 2(1), 1-18, 2013\. [Invited paper - [full version](http://www.dt.fee.unicamp.br/~tiago/smsspamcollection/IJISS13.pdf)]
+
+The original data is available from the [author's website](http://www.dt.fee.unicamp.br/~tiago/smsspamcollection/).

python-scipy-cluster-optimize/cluster_sms_spam.py

@@ -1,3 +1,10 @@
+"""
+Clustering example using an SMS spam dataset with SciPy.
+
+Associated with the Real Python article
+Scientific Python: Using SciPy for Optimization
+Available at: https://realpython.com/python-scipy-cluster-optimize/
+"""
 from pathlib import Path
 import numpy as np
 from scipy.cluster.vq import whiten, kmeans, vq

python-scipy-cluster-optimize/minimize_constrained.py

@@ -1,3 +1,10 @@
+"""
+Constrained minimization example code using SciPy.
+
+Associated with the Real Python article
+Scientific Python: Using SciPy for Optimization
+Available at: https://realpython.com/python-scipy-cluster-optimize/
+"""
 import numpy as np
 from scipy.optimize import minimize, LinearConstraint
 

python-scipy-cluster-optimize/minimize_scalar.py

@@ -1,3 +1,10 @@
+"""
+Scalar function minimization example using SciPy.
+
+Associated with the Real Python article
+Scientific Python: Using SciPy for Optimization
+Available at: https://realpython.com/python-scipy-cluster-optimize/
+"""
 from scipy.optimize import minimize_scalar