finished the fork docu

2026-07-03 11:48:43 +02:00
parent c3e1ffa3f3
commit c3c06ae88c
11 changed files with 31 additions and 0 deletions
@@ -76,6 +76,37 @@ changes were mostly cosmetically (e.g. typos, better rendering, inserting subtit

 First you make sure that all changes are pushed to your forked repository.

+Now you should have a button on the webinterface that will create a *New Pull Request*. Otherwise you can 
+initiate a pull request from the original repository `Controls/gitea-pages` by changing into the
+*Pull Request* tab.
+
+![Create a pull request from your forked repository](images/giteaFork_5.png)
+
+In the following window you should add a one-line comment that summarizes you commit messages.
+Afterwards you create the pull request.
+
+![Comment on the pull request](images/giteaFork_6.png)
+
+Now you can see your pull request in the tab of the original repository `Controls/gitea-pages`. 
+
+![Pull request tab](images/giteaFork_7.png)
+
+To accept the pull request (not all people might have the rights to do so), click on the listed item
+and select <br>
+`Create squash commit`
+
+![Create squash commit](images/giteaFork_8.png)
+
+This will squash all commits you did on the fork into just one commit in the master branch. It
+is requested to do so in case all your commits were creating just one documentation page and committed
+several times to save intermedite results or correct typos and wrong formatting.
+
+After your changes were merged into the master branch you can either delete your forked repository
+and checked out directory (be very sure that you delete the inteded stuff!) or you can later
+reuse your fork for creating another documentation. In the second case use the commands <br>
+`git fetch upstream master` <br>
+`git reset --hard upstream/master` <br>
+`git push --force origin master` <br>


 ## Debugging Problems