Docs currently contains some placeholders such as {extension.name} in Settings.cfg which look like they will be replaced automatically, but this is not the case.

So, I think we should not use tags in braces which look like they will be replaced when they are not. Or, make it possible to automatically replace some variables.

from Slack:

README.rst:
_can be dropped: https://forge.typo3.org/projects/typo3cms-doc-official-extension-template/issues
.. _Documentation Team: https://forge.typo3.org/projects/typo3cms-doc-official-extension-template

This issue was created, based on feedback from the community.

People find it disturbing to click multiple times on "next" to find the basic information inside an extension manual. We should think about changing the example manual to change this.

The "What does it do" should be on the first page. The TOC should not be rendered at all, as this duplicates the TOC in the sidebar.

Also Versions and further detail information might be placed in an appendix. The version is already rendered in the top left corner on each page, same goes for the extension name.

Related:

• Define general structure of a manual
• Optimize start page of manuals

In this repo, tab is used to indent in the .rst files.

But, we document to use spaces (3) in our Coding Guidelines and the .editorconfig contains this convention as well.

Ok, if I change this? Anything else I must consider?

Hi, I get the following error message (only if indexing API is activated) when saving a job. The table really does not exist in the DB and is not created via the analysis database.

Core: Exception handler (WEB): Uncaught TYPO3 Exception: #1472074485: Table 'db.tx_jobapplications_domain_model_ttcontent' doesn't exist | TYPO3\CMS\Extbase\Persistence\Generic\Storage\Exception\SqlErrorException thrown in file /typo3_src-10.4.5/typo3/sysext/extbase/Classes/Persistence/Generic/Storage/Typo3DbBackend.php in line 375. Requested URL:

Hi,
trying to send the command "abgeschlossene löschen" in TYPO3 BE I'll get;

[24-Sep-2023 10:42:31] WARNING: [pool typo3-11] child 3446167 said into stderr: "NOTICE: PHP message: PHP Fatal error: Allowed memory size of nnnn bytes exhausted (tried to allocate 20480 bytes) in typo3_src/typo3_src-11.5.30/typo3/sysext/extbase/Classes/DomainObject/AbstractDomainObject.php on line 218"

https://wwww.host.de/typo3/module/tools/TaskqueueTaskqueue?
token=53645615038777ecd70e161a5a6bae5b1f2fdb80
&tx_taskqueue_tools_taskqueuetaskqueue%5Baction%5D=deleteFinished
&tx_taskqueue_tools_taskqueuetaskqueue%5Bcontroller%5D=Task

At this moment our Taskq contains 102.480 tasks

    /**
     * action delete finished tasks
     *
     * @throws StopActionException
     * @throws UnsupportedRequestTypeException
     * @throws IllegalObjectTypeException
     */
    public function deleteFinishedAction(): void
    {
        $tasks = $this->taskRepository->findFinished();
        $this->addFlashMessageForDeletion($tasks);
        foreach ($tasks as $task) {
            $this->taskRepository->remove($task);
        }
        $this->redirect('list');
    }

Maybe it would be better so create & call a taskRepository->deleteFinished() Method.
Something like this - untested:

    /**
     * delete all finished tasks
     * @return int
     */
    public function deleteFinished(): int
    {
        $queryBuilder = $this->connectionPool->getQueryBuilderForTable('tx_taskqueue_domain_model_task');
        $affectedRows = $queryBuilder
            ->delete('tx_taskqueue_domain_model_task')
            ->where(
                $queryBuilder->expr()->eq('status', TaskInterface::FINISHED)
            )
            ->executeStatement();
        return count($affectedRows);
    }

Absolute paths don't have to be adjusted depending on where the page lies

from Slack:

Documentation/KnownProblems/Index.rst:
bug tracker <http://forge.typo3.org/projects/typo3cms-doc-official-extension-template/issues>

Related: TYPO3-Documentation/T3DocTeam#89

from Slack:

Documentation/Links.rst:
https://forge.typo3.org/projects/extension-/issues

See https://docs.typo3.org/typo3cms/HowToDocument/GeneralConventions/Licenses.html

Related: TYPO3-Documentation/TYPO3CMS-Guide-HowToDocument#67

What should be in the sample extension manual? What should be added / removed?

Related:

• start page #24