Add an upgrade guide to the documentation

[rowild]

Add upgrade guide as discussed here: #7

[rowild]

I have no idea why this PR shows other commits from 4 months ago... I forked the repo anew and created a dedicated branch for this commit. However, it seems that I did something wrong. If this causes any troubles, let me know and I provide a new PR.

Set to "In progress" for the moment.

[rowild]

In a commit I wrote:

The upgrade guide tries to cover as many steps as possible, at least those I encountered during the update. Is there anything I didn't think of? Or do you think those are too many?

Please let me know! Thanks!

[gilbertsoft]

I have no idea why this PR shows other commits from 4 months ago... I forked the repo anew and created a dedicated branch for this commit. However, it seems that I did something wrong. If this causes any troubles, let me know and I provide a new PR.

Set to "In progress" for the moment.

Did you also delete your local clone? If you remove the fork the new one should be up to date with the upstream. And since some time there is a new feature at GH to synchronize your existing fork with the upstream:

But it looks this should not be an issue, no changes are shown from the previous commits.

[gilbertsoft]

Thanks for your PR. I like to get rid of the current issues in

ddev-typo3-src/bin/install-typo3

Lines 98 to 108 in 86eca96

	# Setup links according to the docs see https://docs.typo3.org/m/typo3/guide-installation/master/en-us/QuickInstall/GetAndUnpack/Index.html
	echo -e "${COLOR_INFORMATION}Create symlinks...${COLOR_RESET}"
	echo -e " ${TYPO3_SRC_DIRECTORY} -> ${DDEV_DOCROOT}/typo3_src"
	ln -frs "${TYPO3_SRC_DIRECTORY}" "${DDEV_DOCROOT}/typo3_src"
	echo -e " ${TYPO3_SRC_DIRECTORY}/index.php -> ${DDEV_DOCROOT}/index.php"
	ln -frs "${TYPO3_SRC_DIRECTORY}/index.php" "${DDEV_DOCROOT}/index.php"
	echo -e " ${TYPO3_SRC_DIRECTORY}/typo3 -> ${DDEV_DOCROOT}/typo3"
	ln -frs "${TYPO3_SRC_DIRECTORY}/typo3" "${DDEV_DOCROOT}/typo3"

After that the upgrade instruction should get shorter...

I will add my changes to your PR here so we get rid of it in one step.

[rowild]

Thinking out loud: Reading through the TYPO3 and the ddev docs I observe that the public folder is usually called just that: public. This repo, however, uses htdocs. I was wondering if going along with the more-or-less standard naming conventions wouldn't be better?

[gilbertsoft]

Thinking out loud: Reading through the TYPO3 and the ddev docs I observe that the public folder is usually called just that: public. This repo, however, uses htdocs. I was wondering if going along with the more-or-less standard naming conventions wouldn't be better?

I've called it htdocs back then because many cheap hosters name it like this. But you can simply change it in the config.yaml, the install script reads that path from the environment variable.

[gilbertsoft]

Thanks! I did some minor changes and also added my fix of the install script. I did a force push to the branch to get rid of the 3 unwanted commits so please use git pull --force to get these changes.