Skip to content

Commit

Permalink
This commit updates the documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
@seanmcn
seanmcn committed Oct 31, 2023
1 parent 92fcd5c commit e3d38d7
Show file tree
Hide file tree
Showing 32 changed files with 472 additions and 3,633 deletions.
129 changes: 57 additions & 72 deletions docs/classes/DocGenerator.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<embed> <a href="/docs/README.md">BumbleDocGen</a> <b>/</b> DocGenerator<hr> </embed>

<h1>
<a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L37">DocGenerator</a> class:
<a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L38">DocGenerator</a> class:
</h1>


Expand Down Expand Up @@ -34,17 +34,14 @@ final class DocGenerator

<ol>
<li>
<a href="#maddmissingdocblocks">addMissingDocBlocks</a>
<a href="#madddocblocks">addDocBlocks</a>
- <i>Generate missing docBlocks with ChatGPT for project class methods that are available for documentation</i></li>
<li>
<a href="#mfillinreadmemdtemplate">fillInReadmeMdTemplate</a>
</li>
<li>
<a href="#mgenerate">generate</a>
- <i>Generates documentation using configuration</i></li>
<li>
<a href="#mgenerateprojecttemplatesstructure">generateProjectTemplatesStructure</a>
- <i>Generate documentation structure with blank templates using AI tools</i></li>
<a href="#mgeneratereadmetemplate">generateReadmeTemplate</a>
</li>
<li>
<a href="#mparseandgetrootentitycollectionsgroup">parseAndGetRootEntityCollectionsGroup</a>
</li>
Expand All @@ -55,11 +52,11 @@ final class DocGenerator
<ul>
<li><a name="qlog-file-name"
href="#qlog-file-name">#</a>
<code>LOG_FILE_NAME</code> <b>|</b> <a href="/src/DocGenerator.php#L40">source
<code>LOG_FILE_NAME</code> <b>|</b> <a href="/src/DocGenerator.php#L41">source
code</a> </li>
<li><a name="qversion"
href="#qversion">#</a>
<code>VERSION</code> <b>|</b> <a href="/src/DocGenerator.php#L39">source
<code>VERSION</code> <b>|</b> <a href="/src/DocGenerator.php#L40">source
code</a> </li>
</ul>

Expand All @@ -74,7 +71,7 @@ final class DocGenerator
<ul>
<li><a name="m-construct" href="#m-construct">#</a>
<b>__construct</b>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L42">source code</a></li>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L43">source code</a></li>
</ul>

```php
Expand Down Expand Up @@ -154,18 +151,35 @@ public function __construct(\Symfony\Component\Filesystem\Filesystem $fs, \Symfo
<div class='method_description-block'>

<ul>
<li><a name="maddmissingdocblocks" href="#maddmissingdocblocks">#</a>
<b>addMissingDocBlocks</b>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L144">source code</a></li>
<li><a name="madddocblocks" href="#madddocblocks">#</a>
<b>addDocBlocks</b>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L83">source code</a></li>
</ul>

```php
public function addMissingDocBlocks(): void;
public function addDocBlocks(\BumbleDocGen\AI\ProviderInterface $aiProvider): void;
```

<blockquote>Generate missing docBlocks with ChatGPT for project class methods that are available for documentation</blockquote>

<b>Parameters:</b> not specified
<b>Parameters:</b>

<table>
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>$aiProvider</td>
<td><a href='https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/ProviderInterface.php'>\BumbleDocGen\AI\ProviderInterface</a></td>
<td>-</td>
</tr>
</tbody>
</table>

<b>Return value:</b> <a href='https://www.php.net/manual/en/language.types.void.php'>void</a>

Expand All @@ -184,49 +198,6 @@ public function addMissingDocBlocks(): void;
<li>
<a href="/docs/classes/InvalidConfigurationParameterException.md">\BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException</a></li>

<li>
<a href="https://github.com/tectalichq/public-openai-client-php/blob/master/src/ClientException.php">\Tectalic\OpenAi\ClientException</a></li>

</ul>

</div>
<hr>
<div class='method_description-block'>

<ul>
<li><a name="mfillinreadmemdtemplate" href="#mfillinreadmemdtemplate">#</a>
<b>fillInReadmeMdTemplate</b>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L233">source code</a></li>
</ul>

```php
public function fillInReadmeMdTemplate(): void;
```



<b>Parameters:</b> not specified

<b>Return value:</b> <a href='https://www.php.net/manual/en/language.types.void.php'>void</a>


<b>Throws:</b>
<ul>
<li>
<a href="/docs/classes/ReflectionException.md">\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Exception\ReflectionException</a></li>

<li>
<a href="https://github.com/PHP-DI/PHP-DI/blob/master/src/DependencyException.php">\DI\DependencyException</a></li>

<li>
<a href="https://github.com/tectalichq/public-openai-client-php/blob/master/src/ClientException.php">\Tectalic\OpenAi\ClientException</a></li>

<li>
<a href="https://github.com/PHP-DI/PHP-DI/blob/master/src/NotFoundException.php">\DI\NotFoundException</a></li>

<li>
<a href="/docs/classes/InvalidConfigurationParameterException.md">\BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException</a></li>

</ul>

</div>
Expand All @@ -236,7 +207,7 @@ public function fillInReadmeMdTemplate(): void;
<ul>
<li><a name="mgenerate" href="#mgenerate">#</a>
<b>generate</b>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L316">source code</a></li>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L252">source code</a></li>
</ul>

```php
Expand Down Expand Up @@ -265,36 +236,50 @@ public function generate(): void;
<div class='method_description-block'>

<ul>
<li><a name="mgenerateprojecttemplatesstructure" href="#mgenerateprojecttemplatesstructure">#</a>
<b>generateProjectTemplatesStructure</b>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L83">source code</a></li>
<li><a name="mgeneratereadmetemplate" href="#mgeneratereadmetemplate">#</a>
<b>generateReadmeTemplate</b>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L167">source code</a></li>
</ul>

```php
public function generateProjectTemplatesStructure(): void;
public function generateReadmeTemplate(\BumbleDocGen\AI\ProviderInterface $aiProvider): void;
```

<blockquote>Generate documentation structure with blank templates using AI tools</blockquote>

<b>Parameters:</b> not specified

<b>Parameters:</b>

<table>
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>$aiProvider</td>
<td><a href='https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/ProviderInterface.php'>\BumbleDocGen\AI\ProviderInterface</a></td>
<td>-</td>
</tr>
</tbody>
</table>

<b>Return value:</b> <a href='https://www.php.net/manual/en/language.types.void.php'>void</a>


<b>Throws:</b>
<ul>
<li>
<a href="https://github.com/tectalichq/public-openai-client-php/blob/master/src/ClientException.php">\Tectalic\OpenAi\ClientException</a></li>

<li>
<a href="https://github.com/PHP-DI/PHP-DI/blob/master/src/NotFoundException.php">\DI\NotFoundException</a></li>

<li>
<a href="/docs/classes/ReflectionException.md">\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Exception\ReflectionException</a></li>

<li>
<a href="https://github.com/PHP-DI/PHP-DI/blob/master/src/DependencyException.php">\DI\DependencyException</a></li>

<li>
<a href="https://github.com/PHP-DI/PHP-DI/blob/master/src/NotFoundException.php">\DI\NotFoundException</a></li>

<li>
<a href="/docs/classes/InvalidConfigurationParameterException.md">\BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException</a></li>

Expand All @@ -307,7 +292,7 @@ public function generateProjectTemplatesStructure(): void;
<ul>
<li><a name="mparseandgetrootentitycollectionsgroup" href="#mparseandgetrootentitycollectionsgroup">#</a>
<b>parseAndGetRootEntityCollectionsGroup</b>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L68">source code</a></li>
<b>|</b> <a href="https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L69">source code</a></li>
</ul>

```php
Expand Down
2 changes: 1 addition & 1 deletion docs/shared_c.cache
View file

Large diffs are not rendered by default.

Loading

0 comments on commit e3d38d7

Please sign in to comment.