Stefan Seyfried wrote a startup guide for s2ram, which can be found at http://suspend.sf.net/s2ram-support.html.
For a comprehensive description of the whole software suspend infrastructure please see kernel documentation under Documentation/power; for documentation of the userland suspend API see Documentation/power/userland-swsusp.txt.