Better wording

Author: gagik

Realm/Realm.Weaver/RealmWeaver.cs

@@ -258,7 +258,7 @@ private static void RemoveBackingFields(TypeDefinition type, HashSet<MetadataTok
                 }
             }
 
-            // Iterates through all constructor's instructions from the end to start.
+            // Iterates through all constructors' instructions from the end to start.
             foreach (var constructor in type.GetConstructors())
             {
                 // Index of the most recent "Stfld <backing_field>" instruction
@@ -278,8 +278,8 @@ private static void RemoveBackingFields(TypeDefinition type, HashSet<MetadataTok
                     }
 
                     // If it comes across "Ldarg 0",
-                    // it considers this the start index of backing field initializaion instructions.
-                    // And removes all backing field instructions from end to start.
+                    // it considers this the start index of backing field initializaion instructions
+                    // and removes all backing field instructions from end to start.
                     else if (instruction.OpCode == OpCodes.Ldarg_0)
                     {
                         for (var j = backingFieldInstructionsEnd; j >= i; j--)

Tests/Realm.Tests/Database/RealmObjectTests.cs

@@ -523,16 +523,15 @@ public void RealmObject_Equals_WhenOtherIsNull_ReturnsFalse()
         [Test]
         public void RealmObject_InitializedFields_GetCorrectValues()
         {
-            // This tests the Realm object for a scenario like i.e. where we have a class that
-            // has an ID field that gets incremented every time a new class instance is created
-            // by incrementing an external variable and assigning it to the Id field.
+            // This test ensures we only run the initialization instructions of Realm Object fields once.
+            // i.e. where we have a class that has an ID field that gets incremented every time a new class
+            // instance is created by incrementing an external variable and assigning it to the Id field.
             //
             // class FieldObject { Id: Generator.Id() } where Generator.Id = () => _currentId++;
             //
-            // It could be that because of i.e. copying over initialization commands to
-            // the accessor but not removing from the original constructor, the initialization
-            // of the field would get repeated, thus leading to the _currentId being incremented
-            // twice. This test ensures we only run the initialization of fields once.
+            // It could be that because of i.e. copying over initialization commands to the accessor
+            // but not removing from the original constructor, the initialization of the field
+            // would get repeated, thus leading to the _currentId being incremented twice.
             var obj0 = new InitializedFieldObject();
             var obj1 = new InitializedFieldObject();
             var obj2 = new InitializedFieldObject();