diff --git a/src/Composer/DependencyResolver/Rule.php b/src/Composer/DependencyResolver/Rule.php
index 9c1fc0b48..cba9400ef 100644
--- a/src/Composer/DependencyResolver/Rule.php
+++ b/src/Composer/DependencyResolver/Rule.php
@@ -30,7 +30,7 @@ class Rule
     const RULE_PACKAGE_ALIAS = 13;
 
     /**
-     * The literals this rule consists of.
+     * READ-ONLY: The literals this rule consists of.
      * @var array
      */
     public $literals;
diff --git a/src/Composer/DependencyResolver/RuleSet.php b/src/Composer/DependencyResolver/RuleSet.php
index 0b237736f..439a438b5 100644
--- a/src/Composer/DependencyResolver/RuleSet.php
+++ b/src/Composer/DependencyResolver/RuleSet.php
@@ -23,9 +23,9 @@ class RuleSet implements \IteratorAggregate, \Countable
     const TYPE_LEARNED = 4;
 
     /**
-     * Lookup table for rule id to rule object
+     * READ-ONLY: Lookup table for rule id to rule object
      *
-     * @var array
+     * @var Rule[]
      */
     public $ruleById;
 
diff --git a/src/Composer/Package/BasePackage.php b/src/Composer/Package/BasePackage.php
index e0f0eb22c..677d5074d 100644
--- a/src/Composer/Package/BasePackage.php
+++ b/src/Composer/Package/BasePackage.php
@@ -45,8 +45,7 @@ abstract class BasePackage implements PackageInterface
     );
 
     /**
-     * The package id, public for fast access in dependency solver
-     * Use getId() unless called extremely frequently.
+     * READ-ONLY: The package id, public for fast access in dependency solver
      * @var int
      */
     public $id;