Deprecated directive without attributes

Directives must contain a Directive attribute and when applicable Option attributes.

#[Directive(name: 'example')]
#[Option(name: 'option1', type: OptionType::Boolean, description: 'An example option', default: false)]
class ExampleSubDirective extends SubDirective
{
    public function createNode(\phpDocumentor\Guides\RestructuredText\Nodes\DirectiveNode $directiveNode): Node
    {
        return new ExampleNode(
            $this->readOption($directiveNode, 'option1'),
            $directiveNode->getDataNode(),
            $this->text,
            $directiveNode->getChildren(),
        );
    }
}

The new way of defining directives allows us to do validation on the options set on the DirectiveNode. But also brings us closer to the options to do validation on the parsed document. Directives migrated to this new setup MUST implement the createNode method, which is responsible for the creation of the final node used during rendering.

Steps to migrate:

• Move the logic to create the node(s) created by the directive into the createNode method.
• Remove the getName and getAliases method and replace them with the Directive attribute
• Remove the processSub and process methods

More info

Read more about directive in our docs: https://docs.phpdoc.org/components/guides/guides/developers/directive.html#implement-a-sub-directive

See: https://github.com/phpDocumentor/guides/pull/1231