docs: update platform-specific notes