fixup! fixup! docs: add and update docstrings for analysis points and transformations

Author: AayushSabharwal

src/systems/analysis_points.jl

@@ -5,10 +5,10 @@
 Create an AnalysisPoint for linear analysis. Analysis points can be created by calling
 
 ```
-connect(in, :ap_name, out...)
+connect(out, :ap_name, in...)
 ```
 
-Where `in` is the input to the connection, and `out...` are the outputs. All involved
+Where `out` is the output being connected to the inputs `in...`. All involved
 connectors (input and outputs) are required to either have an unknown named
 `u` or a single unknown, all of which should have the same size.