Merge pull request #1077 from phpDocumentor/docs-fix-links

[DOCS] Fix links to api docs

Author: jaapio

Makefile

@@ -1,4 +1,5 @@
 PHP_BIN = docker run -it --rm --user $$(id -u):$$(id -g) -v${PWD}:/opt/project -w /opt/project php:8.2-cli php -d memory_limit=1024M
+PHP_DOC = docker run --rm -v ${PWD}:/data -w /data phpdoc/phpdoc:3-unstable
 
 .PHONY: help
 help: ## Displays this list of targets with descriptions
@@ -90,7 +91,7 @@ add-license:
 
 .PHONY: docs
 docs: ## Render documentation
-	$(PHP_BIN) tools/phpDocumentor.phar
+	$(PHP_DOC) run
 
 .PHONY: docs-watch
 docs-watch: ## Render documentation and watch for changes

docs/components/guidesXml.rst

@@ -37,7 +37,7 @@ it at :file:`packages/guides-cli/resources/schema/guides.xsd` in the
 mono repository.
 
 Register the new configuration option in the :php:`TreeBuilder` at
-:php:func:`phpDocumentor\Guides\DependencyInjection\GuidesExtension::getConfigTreeBuilder`.
+:php:method:`phpDocumentor\Guides\DependencyInjection\GuidesExtension::getConfigTreeBuilder()`.
 
 ..  seealso::
 
@@ -60,7 +60,7 @@ Save a configuration value into the :php:`ProjectSettings`
 
 To add a configuration value to the :php:`ProjectSettings`,
 register the setting in
-:php:func:`phpDocumentor\Guides\DependencyInjection\GuidesExtension::load`.
+:php:method:`phpDocumentor\Guides\DependencyInjection\GuidesExtension::load()`.
 
 ..  code-block:: php
     :caption: phpDocumentor\Guides\DependencyInjection\GuidesExtension::load
@@ -73,6 +73,6 @@ Save a configuration value to the :php:`ProjectNode`
 ----------------------------------------------------
 
 Additional settings can be added to the ProjectNode in a
-:php:`phpDocumentor\Guides\Event\PostProjectNodeCreated` event.
+:php:class:`phpDocumentor\Guides\Event\PostProjectNodeCreated` event.
 
 ..  todo: Add example

docs/developers/compiler.rst

@@ -10,14 +10,14 @@ Also, this guide assumes you have an :ref:`extension <developer-extension>` set
 
 If you want to extend the compiler to support new features there are two options:
 
-- Implement a :php:class:`phpDocumentor\Guides\Compiler\NodeTransformer`
-- Implement a :php:class:`phpDocumentor\Guides\Compiler\CompilerPass`
+- Implement a :php:interface:`phpDocumentor\Guides\Compiler\NodeTransformer`
+- Implement a :php:interface:`phpDocumentor\Guides\Compiler\CompilerPass`
 
 NodeTransformer
 ===============
 
 Node transformers are used to transform specific types of nodes in the AST. This is useful when you want to remove
-a node type or manipulate nodes of a specific type. Your new node transformer should implement the :php:class:`phpDocumentor\Guides\Compiler\NodeTransformer`
+a node type or manipulate nodes of a specific type. Your new node transformer should implement the :php:interface:`phpDocumentor\Guides\Compiler\NodeTransformer`
 interface and you should register it in the dependency injection container.
 
 .. code-block:: php
@@ -40,7 +40,7 @@ CompilerPass
 ============
 
 If you want to do more complex transformations, for example transformations that require multiple nodes to be transformed
-you should implement a :php:class:`phpDocumentor\Guides\Compiler\CompilerPass`. A compiler pass needs to be registered
+you should implement a :php:interface:`phpDocumentor\Guides\Compiler\CompilerPass`. A compiler pass needs to be registered
 just like a node transformer.
 
 .. code-block:: php