diff --git a/README.md b/README.md
index 7c0862a..7e10275 100644
--- a/README.md
+++ b/README.md
@@ -165,7 +165,7 @@ Here's an example of how you might document a class:
 Strings will automatically extract the `@doc` provider docstring and any `desc`
 parameter/property docstrings.
 
-Sometimes however, Puppet providers use metaprogramming to create parameters
+Sometimes however, Puppet types use metaprogramming to create parameters
 and methods automatically. In those cases Strings will not be able to document
 them automatically (Strings doesn't execute the code that would generate those
 parameters), so you will need to provide hints on how to document your code. To
@@ -174,7 +174,7 @@ directive `@!puppet.provider.param` which may take types, the parameter name,
 and a description.
 
 ```ruby
-# @!puppet.provider.param my_parameter This parameter needs to be explicitly
+# @!puppet.type.param my_parameter This parameter needs to be explicitly
 # documented as it is generated by mk_resource_methods
 Puppet::Type.newtype(:minifile) do