REST is no longer experimental

src/cowboy_rest.erl

@@ -12,12 +12,10 @@
 %% ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 %% OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-%% @doc Experimental REST protocol implementation.
+%% @doc REST protocol implementation.
 %%
-%% Based on the Webmachine Diagram from Alan Dean and Justin Sheehy, which
+%% Originally based on the Webmachine Diagram from Alan Dean and
-%% can be found in the Webmachine source tree, and on the Webmachine
+%% Justin Sheehy.
-%% documentation available at http://wiki.basho.com/Webmachine.html
-%% at the time of writing.
 -module(cowboy_rest).
 -behaviour(cowboy_sub_protocol).
 

src/cowboy_static.erl

@@ -15,10 +15,10 @@
 %% @doc Static resource handler.
 %%
 %% This built in HTTP handler provides a simple file serving capability for
-%% cowboy applications. It should be considered an experimental feature because
+%% cowboy applications. It is provided as a convenience for small or temporary
-%% of it's dependency on the experimental REST handler. It's recommended to be
+%% environments where it is not preferrable to set up a second server just
-%% used for small or temporary environments where it is not preferrable to set
+%% to serve files. It is recommended to use a CDN instead for efficiently
-%% up a second server just to serve files.
+%% handling static files, preferrably on a cookie-less domain name.
 %%
 %% If this handler is used the Erlang node running the cowboy application must
 %% be configured to use an async thread pool. This is configured by adding the