Repository: sunpy/sunpy

Issue:
Our Map guide page is a terrible introduction to Map
https://docs.sunpy.org/en/stable/guide/data_types/maps.html

If you haven't ever used Map before (maybe have minimal background with solar data) this is a terrible introduction. Sure the information about making a custom map is useful somewhere in our docs, but two paragraphs in at the top of the main guide page?! No.

IMO we should be explaining:

* Why Map exists, what does it give you that just opening the array with `astropy.io.fits` dosen't.
* How to load a map from a FITS file.
* How to plot a map.
* How to view the standardised metadata.
* How to work with coordinates in the frame of the map and plot them.
* submap / rotate / resample etc.


Discussion:
As someone who has been using the guides and docs a lot for the past several months, I'd be happy to edit the Map introduction while keeping the points you listed in mind (if no one else is working on this).
Go ahead, I don't think anyone is working on it. 
Yes please, you are very well placed to write docs, you have just about the perfect level of familiarity and recent trauma from reading our current docs! :stuck_out_tongue: 
Updated content is now at https://docs.sunpy.org/en/latest/tutorial/maps.html - would be good for you to take a look at it @Cadair and decide if it's good enough to close this issue.

Resolving patch:
diff --git a/examples/showcase/where_is_stereo.py b/examples/showcase/where_is_stereo.py
--- a/examples/showcase/where_is_stereo.py
+++ b/examples/showcase/where_is_stereo.py
@@ -38,7 +38,6 @@
 
 hee_frame = HeliocentricEarthEcliptic(obstime=obstime)
 
-
 def get_first_orbit(coord):
     lon = coord.transform_to(hee_frame).spherical.lon
     shifted = Longitude(lon - lon[0])
@@ -47,7 +46,6 @@ def get_first_orbit(coord):
         return coord[:ends[0]]
     return coord
 
-
 ##############################################################################
 # Obtain the locations and trajectories of the various planets and spacecraft.
 # To ensure that each trajectory contains at least one full orbit, we request
@@ -68,7 +66,6 @@ def get_first_orbit(coord):
                                                                         'step': '1d'}))
                   for mission in missions}
 
-
 ##############################################################################
 # Define a convenience function for converting coordinates to plot positions
 # in the ecliptic plane.
@@ -81,7 +78,6 @@ def coord_to_heexy(coord):
 ##############################################################################
 # Set Matplotlib settings to the desired appearance and initialize the axes.
 
-
 mpl.rcParams.update({'figure.facecolor': 'black',
                      'axes.edgecolor': 'white',
                      'axes.facecolor': 'black',
@@ -169,3 +165,8 @@ def coord_to_heexy(coord):
     ax.text(x + 0.05, y, mission_labels[mission], color=color)
 
 plt.show()
+
+# This is necessary to reset the Matplotlib settings after plotting for our documentation.
+# You don't need this in your own code.
+mpl.rcParams.update(mpl.rcParamsDefault)
+mpl.rcParams.update({'axes.titlecolor': 'black'})


Test patch: