Anda sedikit salah membaca dokumen. some_firm.client.newadalah menciptakan baru Clientobjek dari koleksi klien, dan sehingga secara otomatis dapat mengatur firm_iduntuk some_firm.id, sedangkan docs panggil Client.newyang tidak memiliki pengetahuan tentang id setiap Firm sama sekali, sehingga membutuhkan firm_idberlalu untuk itu.
Satu-satunya perbedaan antara some_firm.clients.newdan some_firm.clients.buildsepertinya itu buildjuga menambahkan klien yang baru dibuat ke clientskoleksi:
henrym:~/testapp$ rails c
Loading development environment (Rails 3.0.4)
r:001 > (some_firm = Firm.new).save # Create and save a new Firm
#=> true
r:002 > some_firm.clients # No clients yet
#=> []
r:003 > some_firm.clients.new # Create a new client
#=> #<Client id: nil, firm_id: 1, created_at: nil, updated_at: nil>
r:004 > some_firm.clients # Still no clients
#=> []
r:005 > some_firm.clients.build # Create a new client with build
#=> #<Client id: nil, firm_id: 1, created_at: nil, updated_at: nil>
r:006 > some_firm.clients # New client is added to clients
#=> [#<Client id: nil, firm_id: 1, created_at: nil, updated_at: nil>]
r:007 > some_firm.save
#=> true
r:008 > some_firm.clients # Saving firm also saves the attached client
#=> [#<Client id: 1, firm_id: 1, created_at: "2011-02-11 00:18:47",
updated_at: "2011-02-11 00:18:47">]
Jika Anda membuat objek melalui asosiasi, buildsebaiknya lebih disukai newkarena build menyimpan objek di-memori Anda, some_firm(dalam hal ini) dalam keadaan konsisten bahkan sebelum benda apa pun disimpan ke database.