index.rst.0 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637
  1. Documentation
  2. =============
  3. Welcome to the documentation for phpDocumentor.
  4. phpDocumentor is the de-facto documentation application for PHP projects. Your project can benefit too from more
  5. than 20 years of experience and setting the standard for documenting PHP Applications.
  6. With these tutorials, guides and references we aim to provide you with all the information that you need to optimally
  7. document your code and leverage phpDocumentor to generate an extensive set of documentation for your application.
  8. What does it do?
  9. ----------------
  10. phpDocumentor analyzes the code of your application and generates a set of documentation that describes what each
  11. element in your code does, what it expects and what it returns. With it, you can easily navigate through your codebase
  12. and see how it works without having to read the actual code.
  13. For an example on how that would look like, check the sidebar in
  14. `our own documentation <https://docs.phpdoc.org/latest/>`_.
  15. .. hint::
  16. There is a new feature underway to render handwritten documentation, like the one you are reading now. Check this
  17. space for updates in the coming months.
  18. Where to start?
  19. ---------------
  20. We have divided the documentation into 4 sections:
  21. 1. :doc:`getting-started/index`, which is a series of concise tutorials that will help you get running within minutes.
  22. 2. :doc:`guides/index`, these chapters provide in-depth information in the usage and all features of phpDocumentor.
  23. 3. :doc:`references/index`, here you can find the nitty-gritty lists of commonly used components, options and
  24. configuration.
  25. 4. :doc:`internals/index`, care to contribute to phpDocumentor or interested in its architecture? Then this section
  26. is for you.