Documentator Specification

spec-doc.php

<?php

class CompaniaAerea
{
	protected $politicaOverbooking;

	public function fazReserva(Voo $voo, $numPassageiros)
	{
		if (!$this->politicaOverbooking->permitida($voo, $numPassageiros))
			throw new Exception('BLA');
		
		$voo->numPassageiros += $numPassageiros;
		return true;
	}
}

class Voo
{
	public $capacidadePassageiros = 300;
	public $numPassageiros = 120;
}

class PoliticaOverbooking
{
	public function permitida(Voo $voo, $numPassageiros)
	{
		if (($voo->numPassageiros + $numPassageiros) > ($voo->capacidadePassageiros * 1.1))
			return false;
			
		return true;
	}
}

/* 
 Apartir de um parsing, seria possivel gerar uma documentação assim:
 Compania Aerea faz reserva se a politica overbooking é permitida
*/