Lighting

• Pxr Std Lights (which are RSL lights) were deprecated in RenderMan 21. Create a new Pxr C++ light.  See Adding Light. 
• The new material workflows requires that the most downstream VOP node is a PxrCollect, even for lights. Please insure when loading old scenes that the shop_lightpath points to a PxrCollect VOP.
• Pxr Std Lights (which are RSL lights) were deprecated in RenderMan 21. Create a new Pxr C++ light.  See Adding Light.

Geometry

• Poorly tessellated (non-subdivision) surfaces may show artifacts when rendering like dark edges and outlines. It's recommended to render smooth subdivisions to avoid this artifact. You may also use polygons with no normals defined and then subdivide, RenderMan will compute the normals for you.

...