deploy updates

_sources/howto/install-python-lib.rst.txt

@@ -42,6 +42,11 @@ You can install additional packages yourself, but only at user-permission level.
 CoCalc accounts do not have superuser (root) privileges.
 Software must be installed into user-writeable parts of the filesystem, which are in ``/home/user`` (check the value of ``$HOME``).
 
+.. note::
+
+    After installing a package, you may need to restart your kernel **twice** before you can use it. It takes time to check if a module is available, so for performance reasons Python caches such checks and they could be performed by some libraries, not your code. This makes it necessary to restart the kernel once. In addition, CoCalc often keeps a fresh kernel ready for you to use, so that you don't have to wait for it to start. But this spare kernel may "remember" that your package is not installed, hence it has to be discarded as well.
+
+
 .. warning::
 
     Your project **must** have the :ref:`"Internet access" upgrade <project-upgrades>` in order to download software from a remote repository (e.g. PyPI or Anaconda) to your project.

howto/install-python-lib.html

@@ -203,6 +203,10 @@
 <p>You can install additional packages yourself, but only at user-permission level.
 CoCalc accounts do not have superuser (root) privileges.
 Software must be installed into user-writeable parts of the filesystem, which are in <code class="docutils literal notranslate"><span class="pre">/home/user</span></code> (check the value of <code class="docutils literal notranslate"><span class="pre">$HOME</span></code>).</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>After installing a package, you may need to restart your kernel <strong>twice</strong> before you can use it. It takes time to check if a module is available, so for performance reasons Python caches such checks and they could be performed by some libraries, not your code. This makes it necessary to restart the kernel once. In addition, CoCalc often keeps a fresh kernel ready for you to use, so that you don’t have to wait for it to start. But this spare kernel may “remember” that your package is not installed, hence it has to be discarded as well.</p>
+</div>
 <div class="admonition warning">
 <p class="admonition-title">Warning</p>
 <p>Your project <strong>must</strong> have the <a class="reference internal" href="../project-settings.html#project-upgrades"><span class="std std-ref">“Internet access” upgrade</span></a> in order to download software from a remote repository (e.g. PyPI or Anaconda) to your project.

sitemap.xml

@@ -1,2 +1,2 @@
 <?xml version='1.0' encoding='utf-8'?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><url><loc>https://doc.cocalc.com/en/compute_server.html</loc></url><url><loc>https://doc.cocalc.com/en/contents.html</loc></url><url><loc>https://doc.cocalc.com/en/signature_features.html</loc></url><url><loc>https://doc.cocalc.com/en/genindex.html</loc></url><url><loc>https://doc.cocalc.com/en/search.html</loc></url></urlset>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><url><loc>https://doc.cocalc.com/en/contents.html</loc></url><url><loc>https://doc.cocalc.com/en/howto/index.html</loc></url><url><loc>https://doc.cocalc.com/en/howto/install-python-lib.html</loc></url><url><loc>https://doc.cocalc.com/en/genindex.html</loc></url><url><loc>https://doc.cocalc.com/en/search.html</loc></url></urlset>