Contribute to Third Party Extension

This chapter addresses contributing to third party extension documentation.

For system extensions, see Contribute to System Extension.

You can contribute to the documentation of any publicly available extension, if the repository is public (e.g. hosted on GitHub). This does not mean, the extension author will be willing or is obligated to merge your change. But, most of the time, useful contributions are welcome.

You can add issues or make changes via patches (e.g. pull requests on GitHub).

If you can make the change yourself, try to submit it as a patch instead of just writing an issue. It depends on the policy of the extension author (see contribution guide for specific repository, if available), but it is usually not required to write an issue. You can just submit a pull request (PR) directly.

Find the Source

First, you need to find out where the source is maintained. Usually, this will be a repository on GitHub. There, you can also check if documentation is already available. It should be a Documentation folder or one of the alternatives mentioned in Start File.

To find the repository, use one of these methods:

Method 2: Find the Source on https://extensions.typo3.org

  1. Go to the extension repository

  2. In the search box, enter the name or extension key

  3. Select the extension

    Link: Show manual
  4. Click take a look in the code

    Link: Take a look in the code

You cannot find system extensions (extensions that are maintained in the core) on https://extensions.typo3.org. System extensions are for example indexed_search, form, impexp, etc.

Find the Rendered Manual

You can also find the rendered documentation:

Method 1: Find Rendered Manual on docs.typo3.org

Go to: Extensions by extension key

Method 2: Find Rendered Manual on https://extensions.typo3.org

  1. Go to the Extension repository

  2. In the search box, enter the name or extension key

  3. Click on “Show Manual”

    Link: Show manual

Note

You cannot find system extensions (extensions that are maintained in the core) on https://extensions.typo3.org.

Follow Contribution Guide

Hopefully, the extension has a contribution guide. You can look at the Github help pages to check for conventions for contribution guides.

In the Github repository, you should find a file like:

  • CONTRIBUTING.md
  • .github/CONTRIBUTING.md
  • etc.

If no contribution guide exists, follow the general conventions for TYPO3 documentation and conventions for creating Pull Requests on Github or contact the author.