If you want the JustWorks(SM), you have to get hardware which is on the Joyent engineering bill of materials' list, or research and buy hardware which illumos has drivers for.
http://eng.joyent.com/manufacturing/bom.html
SmartOS being descended from Solaris has detailed manual pages built into the operating system, because when one runs a real UNIX, one is entitled to comprehensive documentation with lots of examples.
A lot of the Oracle Solaris documentation, which is also very comprehensive, applies to and can be used on illumos derivatives. The SmartOS wiki and the smartos-discuss mailing list are good sources of SmartOS specific enhancements. Did I mention the built-in man pages yet?