docs/packages: Add quick "Creating distribution packages" section.

Needs more details.

1 files changed, 26 insertions, 0 deletions

diff --git a/docs/reference/packages.rst b/docs/reference/packages.rst
index 28f5f9f48..d8d198e62 100644
--- a/docs/reference/packages.rst
+++ b/docs/reference/packages.rst
@@ -199,6 +199,32 @@ Few notes:
    you may want to decrease the amount of frozen modules included.
 
 
+Creating distribution packages
+------------------------------
+
+Distribution packages for MicroPython are created in the same manner
+as for CPython or any other Python implementation, see references at
+the end of chapter. "Source distribution" (sdist) format is used for
+packaging. The post-processing discussed above, (and pre-processing
+discussed in the following section) is achieved by using custom
+"sdist" command for distutils/setuptools. Thus, packaging steps
+remain the same as for standard distutils/setuptools, the user just
+need to override "sdist" command implementation by passing the
+appropriate argument to ``setup()`` call::
+
+    from setuptools import setup
+    import sdist_upip
+
+    setup(
+        ...,
+        cmdclass={'sdist': sdist_upip.sdist}
+    )
+
+The sdist_upip.py module as referenced above can be found in
+`micropython-lib`:
+https://github.com/micropython/micropython-lib/blob/master/sdist_upip.py
+
+
 Application resources
 ---------------------