deploy: e9ce4d089bbb013f870bbc8d58ec796e8f315eb4

1 files changed, 15 insertions, 0 deletions

diff --git a/develop/development/dependencies.html b/develop/development/dependencies.html
index 19cf215053..813ffbcf0a 100644
--- a/develop/development/dependencies.html
+++ b/develop/development/dependencies.html
@@ -321,6 +321,21 @@ be required.</p>
 <p>because <a href="https://github.com/pypa/build"><code>build</code></a> is a standardish tool which
 doesn't require poetry. (It's what we use in CI too). However, you could try
 <code>poetry build</code> too.</p>
+<h1 id="troubleshooting"><a class="header" href="#troubleshooting">Troubleshooting</a></h1>
+<h2 id="check-the-version-of-poetry-with-poetry---version"><a class="header" href="#check-the-version-of-poetry-with-poetry---version">Check the version of poetry with <code>poetry --version</code>.</a></h2>
+<p>At the time of writing, the 1.2 series is beta only. We have seen some examples
+where the lockfiles generated by 1.2 prereleasese aren't interpreted correctly
+by poetry 1.1.x. For now, use poetry 1.1.14, which includes a critical
+<a href="https://github.com/python-poetry/poetry/pull/5973">change</a> needed to remain
+<a href="https://github.com/pypi/warehouse/pull/11775">compatible with PyPI</a>.</p>
+<p>It can also be useful to check the version of <code>poetry-core</code> in use. If you've
+installed <code>poetry</code> with <code>pipx</code>, try <code>pipx runpip poetry list | grep poetry-core</code>.</p>
+<h2 id="clear-caches-poetry-cache-clear---all-pypi"><a class="header" href="#clear-caches-poetry-cache-clear---all-pypi">Clear caches: <code>poetry cache clear --all pypi</code>.</a></h2>
+<p>Poetry caches a bunch of information about packages that isn't readily available
+from PyPI. (This is what makes poetry seem slow when doing the first
+<code>poetry install</code>.) Try <code>poetry cache list</code> and <code>poetry cache clear --all &lt;name of cache&gt;</code> to see if that fixes things.</p>
+<h2 id="try---verbose-or---dry-run-arguments"><a class="header" href="#try---verbose-or---dry-run-arguments">Try <code>--verbose</code> or <code>--dry-run</code> arguments.</a></h2>
+<p>Sometimes useful to see what poetry's internal logic is.</p>
 
                     </main>