Doc update

Author: pitr-ch

.yardopts

@@ -1 +1,7 @@
---protected --no-private --embed-mixins --output-dir ./doc --markup markdown
+--protected
+--no-private
+--embed-mixins
+--output-dir ./doc
+--markup markdown
+-
+lib/concurrent/actress/doc.md

lib/concurrent/actress.rb

@@ -5,7 +5,7 @@
 
 module Concurrent
 
-  # {include:file:lib/concurrent/actress/doc.md}
+  # Fore more information please see {file:lib/concurrent/actress/doc.md Actress quide}.
   module Actress
 
     require 'concurrent/actress/type_check'

lib/concurrent/actress/context.rb

@@ -72,12 +72,12 @@ def self.included(base)
       end
 
       module ClassMethods
-        # behaves as {Actress.spawn} but class_name is omitted
+        # behaves as {Concurrent::Actress.spawn} but class_name is omitted
         def spawn(name_or_opts, *args, &block)
           Actress.spawn spawn_optionify(name_or_opts, *args), &block
         end
 
-        # behaves as {Actress.spawn!} but class_name is omitted
+        # behaves as {Concurrent::Actress.spawn!} but class_name is omitted
         def spawn!(name_or_opts, *args, &block)
           Actress.spawn! spawn_optionify(name_or_opts, *args), &block
         end

lib/concurrent/actress/doc.md

@@ -1,6 +1,6 @@
-# Light-weighted implement of Actors. Inspired by Akka and Erlang.
+# Light-weighted implementation of Actors. Inspired by Akka and Erlang.
 
-Actors are using a thread-pool by default which makes them very cheap to create and discard.
+Actors are sharing a thread-pool by default which makes them very cheap to create and discard.
 Thousands of actors can be created allowing to brake the program to small maintainable pieces
 without breaking single responsibility principles.