twine: add examples (#8924)

pages/common/twine.md

@@ -1,17 +1,16 @@
 # twine
 
 > Utility for publishing Python packages on PyPI.
-> Subcommands such as `twine upload` have their own usage documentation.
+> More information: <https://twine.readthedocs.io/en/stable/#commands>.
-> More information: <https://twine.readthedocs.io>.
-
-- Upload to the Test PyPI [r]epository and verify things look right:
-
-`twine upload -r testpypi dist/*`
 
 - Upload to PyPI:
 
 `twine upload dist/*`
 
+- Upload to the Test PyPI [r]epository to verify things look right:
+
+`twine upload -r testpypi dist/*`
+
 - Upload to PyPI with a specified [u]sername and [p]assword:
 
 `twine upload -u {{username}} -p {{password}} dist/*`
@@ -19,3 +18,19 @@
 - Upload to an alternative repository URL:
 
 `twine upload --repository-url {{repository_url}} dist/*`
+
+- Check that your distribution's long description should render correctly on PyPI:
+
+`twine check dist/*`
+
+- Upload using a specific pypirc configuration file:
+
+`twine upload --config-file {{configuration_file}} dist/*`
+
+- Continue uploading files if one already exists (only valid when uploading to PyPI):
+
+`twine upload --skip-existing dist/*`
+
+- Upload to PyPI showing detailed information:
+
+`twine upload --verbose dist/*`