DDC-1513: Missing documentation for using references in Docs #1900

New Issue

admin · 2026-01-22T13:30:11+01:00

admin commented

2026-01-22 13:30:11 +01:00

Originally created by @doctrinebot on GitHub (Nov 28, 2011).

Originally assigned to: @Ocramius on GitHub.

Jira issue originally created by user base:

I am in the process of switching over from Doctrine 2.0.7 to Doctrine 2.1 and one of the major missing components in my entities was the new use of using the mapping entity.

Example:

<?php
namespace My\Project\Entities;
use Doctrine\ORM\Mapping\Entity as ORM;
/****
 * @ORM\Entity(...)
 */
class Something
{
// Doctrine annotations here
}

The nessecity for this to be included in the entities is (as far as I can tell) nowhere to be found in the docs, so I am a little curious as to how people are supposed to know. I have also had a look here: http://www.doctrine-project.org/blog/doctrine-2-1-beta-release and can see no references too it.

Am I missing something; or is it really just missing from the docs?

Originally created by @doctrinebot on GitHub (Nov 28, 2011). Originally assigned to: @Ocramius on GitHub. Jira issue originally created by user base: I am in the process of switching over from Doctrine 2.0.7 to Doctrine 2.1 and one of the major missing components in my entities was the new use of using the mapping entity. Example: ``` <?php namespace My\Project\Entities; use Doctrine\ORM\Mapping\Entity as ORM; /**** * @ORM\Entity(...) */ class Something { // Doctrine annotations here } ``` The nessecity for this to be included in the entities is (as far as I can tell) nowhere to be found in the docs, so I am a little curious as to how people are supposed to know. I have also had a look here: http://www.doctrine-project.org/blog/doctrine-2-1-beta-release and can see no references too it. Am I missing something; or is it really just missing from the docs?

admin added the Documentation Invalid labels 2026-01-22 13:30:11 +01:00

admin closed this issue

2026-01-22 13:30:12 +01:00

admin commented

2026-01-22 13:30:14 +01:00

@doctrinebot commented on GitHub (Nov 28, 2011):

Comment created by ebernhardson:

I also glanced through the docs and didn't find it. I would suggest it be added to the Annotations Reference page: http://www.doctrine-project.org/docs/orm/2.1/en/reference/annotations-reference.html

@doctrinebot commented on GitHub (Nov 28, 2011): Comment created by ebernhardson: I also glanced through the docs and didn't find it. I would suggest it be added to the Annotations Reference page: http://www.doctrine-project.org/docs/orm/2.1/en/reference/annotations-reference.html

admin commented

2026-01-22 13:30:14 +01:00

@doctrinebot commented on GitHub (Nov 29, 2011):

Comment created by base:

Ahh, so there are some docs about it; http://www.doctrine-project.org/docs/common/2.1/en/reference/annotations.html however they do not seem to be that clear; nor well linked too.

@doctrinebot commented on GitHub (Nov 29, 2011): Comment created by base: Ahh, so there are some docs about it; http://www.doctrine-project.org/docs/common/2.1/en/reference/annotations.html however they do not seem to be that clear; nor well linked too.

admin commented

2026-01-22 13:30:16 +01:00

@malukenho commented on GitHub (Jan 5, 2017):

@Ocramius @lcobucci can be closed as documentation was improved since this.

@malukenho commented on GitHub (Jan 5, 2017): @Ocramius @lcobucci can be closed as documentation was improved since this.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: doctrine/archived-orm#1900