Good documentation definitely helps. However what concerns me more is the growing tendency of Rails and related packages to do more and more "magic" without wa

Good documentation definitely helps. However what concerns me more is the growing tendency of Rails and related packages to do more and more "magic" without warning the user, at the expense of best practices and the principle of least astonishment. The best example I can think of offhand is Bundler "helpfully" invoking sudo to modify your global system settings, as the default option.