minor doc tweak
Further API doc improvements.
Add another incubation example for RP testing.