diff --git a/README.md b/README.md
index d556994..a8653d7 100644
--- a/README.md
+++ b/README.md
@@ -34,7 +34,7 @@ compile("process = _;"; name="passthrough", argv=["-double", "-vec"])
 
 Each call to `compute!` will calculate `block_size` samples and return the
 output as a matrix of (block_size, n_channels). If the program takes input,
-set `dsp.inputs` to a similar matrix before calling `compute!`:
+set `dsp.inputs` to a (block_size, n_channels) matrix before calling `compute!`:
 
 ```julia
 passthrough = init!(compile("process = _, _;"))
@@ -62,5 +62,5 @@ One can then set the values of these params like:
 setparams!(dsp, Dict("/score/freq" => 220.0f0))
 ```
 
-See [examples/portaudio.jl](examples/portaudio.jl) to see how the DSP can be
-wrapped for audio IO.
\ No newline at end of file
+See [examples/portaudio.jl](examples/portaudio.jl) to understand how the DSP can
+be wrapped for audio IO.
\ No newline at end of file
diff --git a/src/Faust.jl b/src/Faust.jl
index d1f6da7..95585e4 100644
--- a/src/Faust.jl
+++ b/src/Faust.jl
@@ -81,7 +81,7 @@ end
 """
     compute!(d)
 
-Computes `d.block_size` samples of signal and returns `d.outputs` (d.blocK_size, n_outputs).
+Computes `d.block_size` samples of signal and returns `d.outputs` (d.block_size, n_outputs).
 
 `d.inputs` should be assigned an incoming signals matrix of dims (d.block_size, n_inputs)
 before calling this function.
@@ -107,7 +107,6 @@ julia> compute!(d)
 -0.96961135
 -0.9522513
 ```
-
 """
 function compute!(d::DSPBlock{T}) where T <: FaustFloat
     computeCDSPInstance(d.dsp, d.block_size, d.inputs, d.outputs)