extended docs.

contracts/crowdsale/distribution/RefundableCrowdsale.sol

@@ -22,6 +22,7 @@ contract RefundableCrowdsale is FinalizableCrowdsale {
   RefundVault public vault;
 
   /**
+   * @dev Constructor, creates RefundVault. 
    * @param _goal Funding goal
    */
   function RefundableCrowdsale(uint256 _goal) public {
@@ -41,6 +42,7 @@ contract RefundableCrowdsale is FinalizableCrowdsale {
   }
 
   /**
+   * @dev Checks whether funding goal was reached. 
    * @return Whether funding goal was reached
    */
   function goalReached() public view returns (bool) {

contracts/crowdsale/emission/AllowanceCrowdsale.sol

@@ -15,6 +15,7 @@ contract AllowanceCrowdsale is Crowdsale {
   address public tokenWallet;
 
   /**
+   * @dev Constructor, takes token wallet address. 
    * @param _tokenWallet Address holding the tokens, which has approved allowance to the crowdsale
    */
   function AllowanceCrowdsale(address _tokenWallet) public {
@@ -23,6 +24,7 @@ contract AllowanceCrowdsale is Crowdsale {
   }
 
   /**
+   * @dev Checks the amount of tokens left in the allowance.
    * @return Amount of tokens left in the allowance
    */
   function remainingTokens() public view returns (uint256) {

contracts/crowdsale/price/IncreasingPriceCrowdsale.sol

@@ -7,7 +7,7 @@ import "../../math/SafeMath.sol";
  * @title IncreasingPriceCrowdsale
  * @dev Extension of Crowdsale contract that increases the price of tokens linearly in time. 
  * Note that what should be provided to the constructor is the initial and final _rates_, that is,
- * the amount of tokens per ETH contributed. Thus, the initial rate must be greater than the final rate.
+ * the amount of tokens per wei contributed. Thus, the initial rate must be greater than the final rate.
  */
 contract IncreasingPriceCrowdsale is TimedCrowdsale {
   using SafeMath for uint256;
@@ -16,6 +16,7 @@ contract IncreasingPriceCrowdsale is TimedCrowdsale {
   uint256 public finalRate;
 
   /**
+   * @dev Constructor, takes intial and final rates of tokens received per wei contributed.
    * @param _initialRate Number of tokens a buyer gets per wei at the start of the crowdsale
    * @param _finalRate Number of tokens a buyer gets per wei at the end of the crowdsale
    */
@@ -27,7 +28,7 @@ contract IncreasingPriceCrowdsale is TimedCrowdsale {
   }
 
   /**
-   * @dev Returns the rate of tokens per ETH at the present time. 
+   * @dev Returns the rate of tokens per wei at the present time. 
    * Note that, as price _increases_ with time, the rate _decreases_. 
    * @return The number of tokens a buyer gets per wei at a given time
    */

contracts/crowdsale/validation/CappedCrowdsale.sol

@@ -14,6 +14,7 @@ contract CappedCrowdsale is Crowdsale {
   uint256 public cap;
 
   /**
+   * @dev Constructor, takes maximum amount of wei accepted in the crowdsale.
    * @param _cap Max amount of wei to be contributed
    */
   function CappedCrowdsale(uint256 _cap) public {
@@ -22,6 +23,7 @@ contract CappedCrowdsale is Crowdsale {
   }
 
   /**
+   * @dev Checks whether the cap has been reached. 
    * @return Whether the cap was reached
    */
   function capReached() public view returns (bool) {

contracts/crowdsale/validation/TimedCrowdsale.sol

@@ -15,6 +15,7 @@ contract TimedCrowdsale is Crowdsale {
   uint256 public endTime;
 
   /**
+   * @dev Constructor, takes crowdsale opening and closing times.
    * @param _startTime Crowdsale opening time
    * @param _endTime Crowdsale closing time
    */
@@ -27,6 +28,7 @@ contract TimedCrowdsale is Crowdsale {
   }
 
   /**
+   * @dev Checks whether the period in which the crowdsale is open has already elapsed.
    * @return Whether crowdsale period has elapsed
    */
   function hasExpired() public view returns (bool) {

contracts/crowdsale/validation/UserCappedCrowdsale.sol

@@ -16,6 +16,7 @@ contract UserCappedCrowdsale is Crowdsale, Ownable {
   mapping(address => uint256) public caps;
 
   /**
+   * @dev Sets a specific user's maximum contribution.
    * @param _beneficiary Address to be capped
    * @param _cap Wei limit for individual contribution
    */
@@ -24,6 +25,7 @@ contract UserCappedCrowdsale is Crowdsale, Ownable {
   }
 
   /**
+   * @dev Returns the cap of a specific user. 
    * @param _beneficiary Address whose cap is to be checked
    * @return Current cap for individual user
    */
@@ -32,6 +34,7 @@ contract UserCappedCrowdsale is Crowdsale, Ownable {
   }
 
   /**
+   * @dev Returns the amount contributed so far by a sepecific user.
    * @param _beneficiary Address of contributor
    * @return User contribution so far
    */

contracts/crowdsale/validation/WhitelistedCrowdsale.sol

@@ -13,20 +13,23 @@ contract WhitelistedCrowdsale is Crowdsale, Ownable {
   mapping(address => bool) public whitelist;
 
   /**
+   * @dev Adds address to whitelist.
    * @param _beneficiary Address to be added to the whitelist
    */
   function addToWhitelist(address _beneficiary) external onlyOwner {
     whitelist[_beneficiary] = true;
   }
 
   /**
+   * @dev Removes address from whitelist. 
    * @param _beneficiary Address to be removed to the whitelist
    */
   function removeFromWhitelist(address _beneficiary) external onlyOwner {
     whitelist[_beneficiary] = false;
   }
 
   /**
+   * @dev Checks whether a specific user is whitelisted. 
    * @param _beneficiary Address to check whether already in the whitelist
    * @return Whether the address is whitelisted
    */