Fix several issues in the documentation (#441)

- Document ground connections
- Document all supported unbalance calculation definitions
- Replace mentions of the deprecated method
`rlf.ElectricalNetwork.from_dgs`
- Document that constant current loads are not allowed on a
short-circuited bus similar to constant power loads
- Improve the short circuit example
- Fix mistakes detected by GitHub copilot

---------

Co-authored-by: Benoît Vinot <benoit.vinot@roseautechnologies.com>

Author: alihamdan

doc/Installation.md

@@ -47,7 +47,7 @@ $ python -m pip install roseau-load-flow
 ````
 
 `````{tip}
-It is recommended to work in a virtual environment to isolate your project. Create and activate a virtual environment
+Working in a virtual environment is recommended to isolate your project. Create and activate a virtual environment
 before installing the package. You can create one with:
 
 ````{tab} Windows

doc/_static/Ground.svg

@@ -24,10 +24,10 @@ electrical components. As a result, some appliances may receive excessive voltag
 power. In severe cases, outlets can become dangerously energized with full phase-to-phase voltage, posing a significant
 risk of equipment damage, electric shock, or fire.
 
-With a perfectly balanced load, the neutral current is zero and the neutral voltage is zero as well. With an unbalanced
-load, the neutral current is non-zero. In this case, it is the role of the neutral to balance the voltage across the
-electrical phases. In a floating neutral situation, the phase-to-phase voltages remain normal, but the 0V reference of
-the neutral gets lost. The larger the load imbalance, the more serious the issue becomes.
+With a perfectly balanced load, both the neutral current and voltage are zero. With an unbalanced load, the neutral
+current is non-zero. In this case, it is the role of the neutral to balance the voltage across the electrical phases. In
+a floating neutral situation, the phase-to-phase voltages remain normal, but the 0V reference of the neutral gets lost.
+The larger the load imbalance, the more serious the issue becomes.
 
 ## Modelling floating neutral in Roseau Load Flow
 

doc/advanced/Floating_Neutral.md

@@ -20,7 +20,7 @@ myst:
 ## General information
 
 The goal is to compute the voltages at each bus and the currents and powers flow in each branch of the network. The
-computation must respect the Kirchhoff's laws and the constraints of the network.
+computation must respect Kirchhoff's laws and the constraints of the network.
 
 More formally, this is done by solving a system of $n$ nonlinear equations with $n$ variables:
 

doc/advanced/Solvers.md

@@ -1,17 +1,40 @@
 \input{Preamble}%
 
 \begin{document}
-\ctikzset{european, straight voltages, cute inductors}%
+\ctikzset{european, straight voltages, cute inductors, label/align=straight}%
 \begin{tikzpicture}[%
     show background rectangle,%
     tight background,%
     background rectangle/.style={fill=white}%
   ]
 
-  \coordinate (g) at (0,0);
+  \coordinate (g) at (0,0);%
+  \coordinate (g top) at (0,1.5);%
   \node[ground] at (g) {};%
   \node[left] at (g) {$\underline{V_{\grm}}$};%
-  \draw (0, 1) to[short, i=$\underline{I_{\grm}}$, -*] (g);
+  \draw (g top) to[short, i=$\underline{I_{\grm}}$, *-*] (g);
+
+  \draw (g top) ++(155:1.25) coordinate (v1 bottom) ++(155:2) coordinate (v1);%
+  \node[above] at (v1) {$\underline{V_1}$};%
+  \draw (v1) to[generic, l_=$\underline{Z_1}$, *-] (v1 bottom) %
+  to[short, i_=$\underline{I_1}$, current/distance=0.2] (g top);%
+
+  \draw (g top) ++(125:1.25) coordinate (v2 bottom) ++(125:2) coordinate (v2);%
+  \node[above] at (v2) {$\underline{V_2}$};%
+  \draw (v2) to[generic, l_=$\underline{Z_2}$, *-] (v2 bottom)%
+  to[short, i=$\underline{I_2}$, current/distance=0.2] (g top);%
+
+  \draw (g top) ++(55:1.25) coordinate (vkm1 bottom) ++(55:2) coordinate (vkm1);%
+  \node[above] at (vkm1) {$\underline{V_{k-1}}$};%
+  \draw (vkm1) to[generic,l=$\underline{Z_{k-1}}$, *-] (vkm1 bottom) %
+  to[short, i_=$\underline{I_{k-1}}$, current/distance=0.2] (g top);%
+
+  \draw (g top) ++(25:1.25) coordinate (vk bottom) ++(25:2) coordinate (vk);%
+  \node[above] at (vk) {$\underline{V_k}$};%
+  \draw (vk) to[generic,l=$\underline{Z_k}$, *-] (vk bottom) %
+  to[short, i=$\underline{I_k}$, current/distance=0.2] (g top);%
+
+  \draw[->,-{Latex[]}, dashed] (g top) +(120:3) arc (120:60:3);%
 
 \end{tikzpicture}
 \end{document}

doc/images/Ground.tex

@@ -17,7 +17,7 @@ myst:
 ## Definition
 
 It represents a multiphase node in the network that other elements (loads, lines, transformers, voltage sources...) can
-connect to. A bus is a placeholder point where we want the voltage to be computed during the load flow.
+connect to. A bus is a node where the voltage is computed during the load flow analysis.
 
 ```{image} /_static/Bus.svg
 ---