WIP

website/docs/commands/publishing/publish.md

@@ -288,6 +288,13 @@ Specify publish repository authentication either on the command-line or via
 using directives. See user / password / realm in the [settings table](#settings)
 and the [CI overrides](#ci-overrides).
 
+### Connection parameters configuration
+
+When publishing to repositories 
+
+Publishing to Sonatype uses a staging repository which may sometimes cause problems when transitioning through states.
+If a publishing process fails with status `500` and message `"Staging repository is already transitioning"` you can try to 
+
 ## Publishing
 
 Once all the necessary settings are set, publish a Scala CLI project with a command