Update online documentation.

Corrected information on polarisations. I forgot to update this page
when I found that the Stokes pols weren't quite right in the code. Also
add some more details.

Fix a mistake and improve the hyperdrive-solutions-format page.

Fix a broken Pawsey link.

mdbook/src/defs/cal_sols_hyp.md

@@ -144,7 +144,7 @@ the observation). Note that this is not necessarily the same as the total number
 of *channels* in the observation; channels may be averaged before calibration,
 making the number of chanblocks less than the number of channels.
 
-`Flag` indicates whether calibration was attempted (1) or not (0) on a chanblock
+`Flag` indicates whether calibration was attempted (0) or not (1) on a chanblock
 (boolean).
 
 `Freq` is the centroid frequency of the chanblock (as a double-precision float).
@@ -194,10 +194,10 @@ obsid = f[0].header["OBSID"]
 pfb_flavour = f[0].header["PFB"]
 start_times = f[0].header["S_TIMES"]
 
-tile_names = [tile[1] for tile in f["TILES"].data]
-tile_flags = [tile[2] for tile in f["TILES"].data]
+tile_names = [tile["TileName"] for tile in f["TILES"].data]
+tile_flags = [tile["Flag"] for tile in f["TILES"].data]
 
-freqs = [chan[1] for chan in f["CHANBLOCKS"].data]
+freqs = [chan["FREQ"] for chan in f["CHANBLOCKS"].data]
 
 cal_precisions_for_timeblock_0 = f["RESULTS"].data[0]
 ```

mdbook/src/defs/pols.md

@@ -6,16 +6,22 @@ polarisation refers to the East-West dipoles and the Y refers to North-South.
 Note that this contrasts with the IAU definition of X and Y, which is opposite
 to this. However, this is consistent within the MWA.
 
-MWA visibilities are ordered XX, XY, YX, YY (using the above definitions of X
-and Y).
+MWA visibilities in raw data products are ordered XX, XY, YX, YY where X is
+East-West and Y is North-South. `Birli` and `cotter` also write pre-processed
+visibilities this way.
+
+`wsclean` expects its input measurement sets to be in the IAU order, meaning
+that, currently, `hyperdrive` outputs are (somewhat) inappropriate for usage
+with `wsclean`. We are discussing how to move forward given the history of MWA
+data processing and expectations in the community.
 
 # Stokes polarisations
 
 In `hyperdrive`:
-- \\( \text{XX} = \text{I} + \text{Q} \\)
-- \\( \text{XY} = \text{U} + i\text{V} \\)
-- \\( \text{YX} = \text{U} - i\text{V} \\)
-- \\( \text{YY} = \text{I} - \text{Q} \\)
+- \\( \text{XX} = \text{I} - \text{Q} \\)
+- \\( \text{XY} = \text{U} - i\text{V} \\)
+- \\( \text{YX} = \text{U} + i\text{V} \\)
+- \\( \text{YY} = \text{I} + \text{Q} \\)
 
 where \\( \text{I} \\), \\( \text{Q} \\), \\( \text{U} \\), \\( \text{V} \\) are
 Stokes polarisations and \\( i \\) is the imaginary unit.

mdbook/src/user/di_cal/garrawarla.md

@@ -1,6 +1,6 @@
 # Usage on garrawarla
 
-[garrawarla](https://support.pawsey.org.au/documentation/display/US/Garrawarla+Documentation)
+[garrawarla](https://support.pawsey.org.au/documentation/display/US/Garrawarla+User+Guide)
 is a supercomputer dedicated to MWA activities hosted by the Pawsey
 Supercomputing Centre. [This MWA wiki
 page](https://wiki.mwatelescope.org/pages/viewpage.action?pageId=52068764)