Local Editing and Rendering with Docker¶
This section walks you through contributing to the documentation with Git and Docker.
If necessary, ask for help as explained in Help & Support.
Get a Github account:
Fill out the form on Join Github.
The general convention in the TYPO3 community is to use your full real name as name (not username), but it is not a requirement.
Be sure to use an email-address that you will regularly check as soon as you upload changes to Github.
Find and fork the repository
Find the repository for the manual you wish to make changes to. On the lower left side of the rendered documentation, click on the link "Related Links". Then click on the link "Repository".
This will direct you to the repository on Github.
There, click on the "Fork" button in the upper right.
The repository will be forked to your workspace on Github. You can delete it later or reuse it for further changes.
Clone the forked repository
Clone the forked repository from your workspace (click Clone or download to copy the URL).
In your terminal:
git clone https://github.com/<USERNAME>/<NAME OF REPOSITORY>.git
Create a branch
For example, use the branch
git checkout -b feature/changes-in-cgl
Using your preferred IDE or editor, make changes to the files. Make sure you adhere to Coding Guidelines for reST Files, e.g. use 3 spaces to indent (not tabs).
If you are not familier with reST, you might want to check out reST Introduction first!
Render the documentation
Render with Docker in order to test the changes (see Rendering Documentation With Docker).
# this does a docker run and makes the # command dockrun_t3rdf available in your current terminal source <(docker run --rm t3docs/render-documentation show-shell-commands) # build documentation, will create directory Documentation-GENERATED-temp dockrun_t3rdf makehtml # open result in Browser # on MacOS: open "file:///$(pwd)/Documentation-GENERATED-temp/Result/project/0.0.0/Index.html" # on Linux: xdg-open "file:///$(pwd)/Documentation-GENERATED-temp/Result/project/0.0.0/Index.html"
git commit -a
Write a short commit message, describing what was changed, for example "Fix link". See Commit Messages, but keep in mind that the conventions for commit messages for the documentation are not strict.
git push origin changes-in-cgl
This will push the change to your forked repository.
Create Pull request
Now, in your browser, visit the forked repository in your GitHub workspace. Github will already make some suggestions for a pull request and will display your pushed branch as "Your recently pushed branches".
Click on the green button "Compare & pull request" and then "Create pull request".
Wait for someone to review and merge your pull request
You will receive notifications (email) about this. Once your change is merged, you can reload the page (which you fixed) in your browser.
Congratulations! You are now a contributor. Welcome and thank you!