Improved documentation of entity fields

src/Entity/Parts/PartTraits/AdvancedPropertyTrait.php

@@ -43,14 +43,14 @@ trait AdvancedPropertyTrait
     protected bool $needs_review = false;
 
     /**
-     * @var string a comma separated list of tags, associated with the part
+     * @var string A comma separated list of tags, associated with the part
      */
     #[Groups(['extended', 'full', 'import', 'part:read', 'part:write'])]
     #[ORM\Column(type: Types::TEXT)]
     protected string $tags = '';
 
     /**
-     * @var float|null how much a single part unit weighs in grams
+     * @var float|null How much a single part unit weighs in grams
      */
     #[Assert\PositiveOrZero]
     #[Groups(['extended', 'full', 'import', 'part:read', 'part:write'])]

src/Entity/Parts/PartTraits/InstockTrait.php

@@ -36,7 +36,7 @@ use Symfony\Component\Validator\Constraints as Assert;
 trait InstockTrait
 {
     /**
-     * @var Collection|PartLot[] A list of part lots where this part is stored
+     * @var Collection<int, PartLot> A list of part lots where this part is stored
      */
     #[Assert\Valid]
     #[Groups(['extended', 'full', 'import'])]

src/Entity/Parts/PartTraits/ManufacturerTrait.php

@@ -46,7 +46,7 @@ trait ManufacturerTrait
     protected ?Manufacturer $manufacturer = null;
 
     /**
-     * @var string the url to the part on the manufacturer's homepage
+     * @var string The url to the part on the manufacturer's homepage
      */
     #[Assert\Url]
     #[Groups(['full', 'import', 'part:read', 'part:write'])]

src/Entity/Parts/PartTraits/OrderTrait.php

@@ -36,7 +36,7 @@ use Doctrine\ORM\Mapping as ORM;
 trait OrderTrait
 {
     /**
-     * @var Collection<int, Orderdetail> the details about how and where you can order this part
+     * @var Collection<int, Orderdetail> The details about how and where you can order this part
      */
     #[Assert\Valid]
     #[Groups(['extended', 'full', 'import'])]