[HttpFoundation] added some more phpdocs to clarify usage