chore: minor improvement for docs (#4756)

Signed-off-by: ledigang <[email protected]>
Co-authored-by: CoderZhi <[email protected]>

Author: ledigang

action/action.go

@@ -25,7 +25,7 @@ const (
 )
 
 type (
-	// Action is the action can be Executed in protocols. The method is added to avoid mistakenly used empty interface as action.
+	// Action is the action that can be executed in protocols. The method is added to avoid mistakenly using empty interface as action.
 	Action interface {
 		SanityCheck() error
 	}
@@ -89,7 +89,7 @@ func FakeSeal(act Envelope, pubk crypto.PublicKey) *SealedEnvelope {
 	return sealed
 }
 
-// AssembleSealedEnvelope assembles a SealedEnvelope use Envelope, Sender Address and Signature.
+// AssembleSealedEnvelope assembles a SealedEnvelope using Envelope, Sender Address and Signature.
 // This method should be only used in tests.
 func AssembleSealedEnvelope(act Envelope, pk crypto.PublicKey, sig []byte) *SealedEnvelope {
 	sealed := &SealedEnvelope{

api/coreservice.go

@@ -131,7 +131,7 @@ type (
 		ActionByActionHash(h hash.Hash256) (*action.SealedEnvelope, *block.Block, uint32, error)
 		// PendingActionByActionHash returns action by action hash
 		PendingActionByActionHash(h hash.Hash256) (*action.SealedEnvelope, error)
-		// ActionsInActPool returns the all Transaction Identifiers in the actpool
+		// ActionsInActPool returns all Transaction Identifiers in the actpool
 		ActionsInActPool(actHashes []string) ([]*action.SealedEnvelope, error)
 		// BlockByHeightRange returns blocks within the height range
 		BlockByHeightRange(uint64, uint64) ([]*apitypes.BlockWithReceipts, error)
@@ -145,7 +145,7 @@ type (
 		EstimateMigrateStakeGasConsumption(context.Context, *action.MigrateStake, address.Address) (uint64, []byte, error)
 		// EstimateGasForNonExecution  estimates action gas except execution
 		EstimateGasForNonExecution(action.Action) (uint64, error)
-		// EstimateExecutionGasConsumption estimate gas consumption for execution action
+		// EstimateExecutionGasConsumption estimates gas consumption for execution action
 		EstimateExecutionGasConsumption(ctx context.Context, sc action.Envelope, callerAddr address.Address, opts ...protocol.SimulateOption) (uint64, []byte, error)
 		// LogsInBlockByHash filter logs in the block by hash
 		LogsInBlockByHash(filter *logfilter.LogFilter, blockHash hash.Hash256) ([]*action.Log, error)
@@ -1777,7 +1777,7 @@ func (core *coreService) estimateMigrateStakeGasConsumptionAt(ctx context.Contex
 	return gas + intrinsicGas, retval, nil
 }
 
-// EstimateExecutionGasConsumption estimate gas consumption for execution action
+// EstimateExecutionGasConsumption estimates gas consumption for execution action
 func (core *coreService) EstimateExecutionGasConsumption(ctx context.Context, elp action.Envelope, callerAddr address.Address, opts ...protocol.SimulateOption) (uint64, []byte, error) {
 	return core.estimateExecutionGasConsumptionAt(ctx, elp, callerAddr, 0, opts...)
 }
@@ -1939,7 +1939,7 @@ func (core *coreService) getProtocolAccount(ctx context.Context, addr string) (*
 	}, out.GetBlockIdentifier(), nil
 }
 
-// ActionsInActPool returns the all Transaction Identifiers in the actpool
+// ActionsInActPool returns all Transaction Identifiers in the actpool
 func (core *coreService) ActionsInActPool(actHashes []string) ([]*action.SealedEnvelope, error) {
 	var ret []*action.SealedEnvelope
 	if len(actHashes) == 0 {

api/grpcserver.go

@@ -396,7 +396,7 @@ func (svr *gRPCHandler) EstimateGasForAction(ctx context.Context, in *iotexapi.E
 	return &iotexapi.EstimateGasForActionResponse{Gas: estimateGas}, nil
 }
 
-// EstimateActionGasConsumption estimate gas consume for action without signature
+// EstimateActionGasConsumption estimates gas consumption for action without signature
 func (svr *gRPCHandler) EstimateActionGasConsumption(ctx context.Context, in *iotexapi.EstimateActionGasConsumptionRequest) (*iotexapi.EstimateActionGasConsumptionResponse, error) {
 	if in.GetExecution() != nil {
 		callerAddr, err := address.FromString(in.GetCallerAddress())
@@ -652,7 +652,7 @@ func (svr *gRPCHandler) GetTransactionLogByBlockHeight(ctx context.Context, in *
 	}, nil
 }
 
-// GetActPoolActions returns the all Transaction Identifiers in the mempool
+// GetActPoolActions returns all Transaction Identifiers in the mempool
 func (svr *gRPCHandler) GetActPoolActions(ctx context.Context, in *iotexapi.GetActPoolActionsRequest) (*iotexapi.GetActPoolActionsResponse, error) {
 	acts, err := svr.coreService.ActionsInActPool(in.ActionHashes)
 	if err != nil {