Documentation/manual model inconsistency ---------------------------------------- Key: HHH-1164 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-1164 Project: Hibernate Core Issue Type: Improvement Components: documentation Affects Versions: 3.1 rc2 Reporter: Rich MacDonald Priority: Trivial The hibernate 3.0.5 manual has an inconsistency that could cause confusion if you're not reading carefully. On p91, section 8.4.1, we see an example of many Persons having the same Address. This is a bidirectional 1-n/n-1. On p92, section 8.5.1, we see the Person-Address association using a join table. But wait, the model has been reversed! Here, one Person has many Addresses. IMHO, the manual would read better if the models were consistent across the examples. FWIW, I'd consider using a different model for the 1-1 associations as well.