Allowed direct append for nodes

[sgrigorjev]

The existing solution with chain methods of document build is well suited for cases when the document structure is predetermined, like so:

$document = (new Document())
    ->bulletlist()
        ->item()
            ->paragraph()
                ->text('item 1')
            ->end()
        ->end()
        ->item()
            ->paragraph()
                ->text('item 2')
            ->end()
        ->end()
    ->end()
;

However, if you need to create a document programmatically, when parts of the document can be repeated or generated independently, a problem arises of how to embed pre-created structures of nodes into the document. When, for example, some nodes must be included in the document under a certain condition, and otherwise must be omitted.
The existing model of document creation does not allow this.
I faced this problem personally when creating articles on Confluence, and thought it would be nice to have it in the library itself.

My proposal is to allow two alternative ways of constructing a document, one existing through a chain of calls, and one through a direct append of nodes.

$document = (new Document())
    ->append(
        (new BulletList())
            ->append(
                (new ListItem())
                    ->append(
                        (new Paragraph())
                            ->append(new Text('item 1'))
                    ),
                (new ListItem())
                    ->append(
                        (new Paragraph())
                            ->append(new Text('item 2'))
                    )
                    
            )
    )
;

In this case, it will be possible to create and append nodes dynamically.

$paragraph = (new Paragraph())->append(new Text('Line 1'));

if (some condition) {
    $paragraph->append(new Text('(doc)', new Link('https://example.com/doc')));
}

$document = (new Document())->append($paragraph);

This will allow to create documents of any complexity and will give developers a powerful tool for working with Atlassian products.

This doesn't require much, just change the visibility scope for method append to public. I also added the ability to append multiple nodes at once.

[sgrigorjev]

The same changes were sent to original DamienHarper/adf-tools repository in pull/16