How to Install and use phpDocumentor

If you have Windows, and are running WAMP, this is the step by step installation guide to getting phpDocumentor to work. This write-up assumes that you have WAMP installed and working.

1. Download Composer from https://getcomposer.org/
2. Run through the installation with the default settings. It will locate php for you automatically. If you're having any issues with the install, Google the response. There shouldn't be any errors though.
3. If you have CMD opened, close it now.
4. Open CMD and type in composer. If something starts happening, Composer is installed correctly.
5. Go to the directory that you want to install phpDocumentor.
6. In your project directory, create a JSON file. Name it, composer.json and add the following code to it
   

   {
       "require-dev": {
           "phpdocumentor/phpdocumentor": "2.*"
       }
   }

7. For example, let's say that your project directory is located in C:/wamp/www/your_project, you're going to want to open CMD and make sure that you've navigated to that directory. Remember cd ../ to move up a directory. If you're in C:/ then type in cd C:/wamp/www/your_project to get into that directory.
8. Now type composer install
9. This will take some time (usually less than a couple of minutes) but will install a new directory called vendor
10. In CMD, type in cd vendor/bin. You're going to be in C:\wamp\www\your_project\vendor\bin
11. Now you can type in phpdoc followed by a command
12. If you want to create documentation for a single file, you'll use -f. If you want to create documentation for the entire directory, you'll use -d. 
13. You're going to want to follow it with a -t that states where the documentation will be going. Create a docs folder in C:\wamp\www\your_project\docs.
14. The last segment that you have a choice of appending is --template. Go to https://www.phpdoc.org/templates to get the available templates. i.e. clean
15. For example, to create documentation for a file go to CMD and in the bin directory, type phpdoc -f "C:\wamp\www\your_project\classes\some_class.php" -t "C:\wamp\www\your_project\docs" --template "responsive-twig"
16. To create documentation for the entire directory, type in the following: phpdoc -d "C:\wamp\www\your_project\classes" -t "C:\wamp\www\your_project\docs" --template "responsive-twig"