Каждый для себя тут выбирает сам. У каждой из этих двух сред есть свои преимущества.
Например в билдере хороший визуальный проектировщик интерфейса, а в Visual С++ 6.0 только редактор ресусов (в Visual studio 2003 и страше он есть правда синтаксис изменился). Но как не крути в для Visual C++ пишуться большинство исходников и сплойтов - это как стандарт. В билдере (а это посути тот же Delphi только синтаксис С++) превосходно работать с базами данных.
Если ты пишешь всякие прикладные програмы для офиса то бери билдер - пока на Visual С++ окно нарисуешь можно десять окошек на билдере сделать, да и все нынче базами данных кормятся. А если пишешь всякие системные и компактные утилиты и сплойты то твой выбор Visual с++. Теперь о документировасти - за студией стоит чёрт знает скольки гиговый MSDN, а все описания и примеры в нём как раз на визуале с++ а за борладном относительно небольшой хелп и MS Programs reference. И последнее за Visual C++ стоит майкрософт и он будет впереди всех по обновлениям