Many of the features provided by Shield are via extensions to external frameworks (e.g. to the Security framework). 5.8 has support for documenting extensions where previous versions do not. Much of the documentation and switch from README is complete but needs 5.8 to work correctly.