Polish docs

internal/db/merge.go

@@ -290,6 +290,7 @@ func (mp *mergeProcessor) mergeComposites(ctx context.Context) error {
 }
 
 // processBlock merges the block and its children to the datastore and sets the head accordingly.
+// If onlyHeads is true, it will skip merging and update only the heads.
 func (mp *mergeProcessor) processBlock(
 	ctx context.Context,
 	block *coreblock.Block,

internal/encryption/nonce.go

@@ -45,6 +45,7 @@ func generateTestNonce() ([]byte, error) {
 func init() {
 	arg := os.Args[0]
 	// If the binary is a test binary, use a deterministic nonce.
+	// TODO: We should try to find a better way to detect this https://github.com/sourcenetwork/defradb/issues/2801
 	if strings.HasSuffix(arg, ".test") || strings.Contains(arg, "/defradb/tests/") {
 		generateNonceFunc = generateTestNonce
 		generateEncryptionKeyFunc = generateTestEncryptionKey

internal/merkle/clock/clock.go

@@ -166,6 +166,7 @@ func encryptBlock(ctx context.Context, block *coreblock.Block) (*coreblock.Block
 }
 
 // ProcessBlock merges the delta CRDT and updates the state accordingly.
+// If onlyHeads is true, it will skip merging and update only the heads.
 func (mc *MerkleClock) ProcessBlock(
 	ctx context.Context,
 	block *coreblock.Block,

internal/merkle/crdt/field.go

@@ -13,8 +13,8 @@ package merklecrdt
 import "github.com/sourcenetwork/defradb/client"
 
 // DocField is a struct that holds the document ID and the field value.
-// This is used to a link between the document and the field value.
-// For example, to check if the field value need be encrypted depending on the document-level
+// This is used to have a link between the document and the field value.
+// For example, to check if the field value needs to be encrypted depending on the document-level
 // encryption is enabled or not.
 type DocField struct {
 	DocID      string

internal/request/graphql/schema/generate.go

@@ -1051,8 +1051,8 @@ func (g *Generator) GenerateMutationInputForGQLType(obj *gql.Object) ([]*gql.Fie
 		Description: createDocumentDescription,
 		Type:        obj,
 		Args: gql.FieldConfigArgument{
-			"input":   schemaTypes.NewArgConfig(mutationInput, "Create field values"),
-			"inputs":  schemaTypes.NewArgConfig(gql.NewList(mutationInput), "Create field values"),
+			"input":   schemaTypes.NewArgConfig(mutationInput, "Create a "+obj.Name()+" document"),
+			"inputs":  schemaTypes.NewArgConfig(gql.NewList(mutationInput), "Create "+obj.Name()+" documents"),
 			"encrypt": schemaTypes.NewArgConfig(gql.Boolean, encryptArgDescription),
 		},
 	}