docs: API documentation

Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>

Author: jkowalleck

README.md

@@ -93,8 +93,10 @@ $bom->getComponents()->addItems(
 ## API documentation
 
 There is no pre-rendered documentation at the time.  
-Instead, there is a prepared config for [phpDoc3](https://docs.phpdoc.org/guide/getting-started/index.html)
-that you can use to generate the docs for yourself.
+Instead, there are code annotations, so that your IDE and tools may pick up the documentation when you use it downstream.
+
+Additionally, there is a prepared config for [phpDoc3](https://docs.phpdoc.org/guide/getting-started/index.html)
+that you can use to generate the docs for yourself.  
 
 ## Conflicts