[DWEB-54] Doctrine 2 Documentation - Yaml Mapping Created: 22/Jul/10  Updated: 01/Dec/10

Status: Open
Project: Doctrine Website
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: Bug Priority: Critical
Reporter: Chris Assignee: Jonathan H. Wage
Resolution: Unresolved Votes: 0
Labels: None


 Description   

The current documentation for the Doctrine2 YAML Mapping ( found here: http://www.doctrine-project.org/projects/orm/2.0/docs/reference/yaml-mapping/en#yaml-mapping )

introduces a wrong format for the identifier colum specification.

I had to go dig around in the source code to find the correct format.
For anyone less persistent or not accustomed to check the source code of a library this would result in serious headache.

WRONG:
id:
id:
type: integer
generator:
strategy: AUTO

RIGHT: (at least with current trunk )
id:
type: integer
id: true
generator:
strategy: AUTO

 Comments   
Comment by Markus Wößner [ 01/Dec/10 ]

It should also be documented how a DB column name other than the field name can be defined. http://www.doctrine-project.org/documentation/manual/2_0/en/basic-mapping#property-mapping suggests "name" would be the correct key. Yet the valid key is "column". Like Chris I had to dig through the code. Well, at least I came to know it.

Generated at Thu May 23 03:14:11 UTC 2013 using JIRA 5.2.7#850-sha1:b2af0c8dc8537b36121c6a579fabbdf79fc919e5.