Skip to content

Commit 7c94037

Browse files
github-actions[bot]linawolfsarahmccarthy123sfinnerWco
authored
[Backport 13.4] [TASK] Refactor installation and setup chapters (#727)
* [TASK] Refactor installation and setup chapters - Assume DDEV and Composer as default - Add quick start installation instructions - Add setup for Development/DDEV application context - Reorder cards and menu for better flow - Link to full installation guide for alternatives releases: main, 13.4 * [TASK] Language checks Releases: main * Apply suggestions from code review Co-authored-by: Sven Finner <[email protected]> * Update Install.rst --------- Co-authored-by: lina.wolf <[email protected]> Co-authored-by: Sarah McCarthy <[email protected]> Co-authored-by: Lina Wolf <[email protected]> Co-authored-by: Sven Finner <[email protected]>
1 parent 125fcf2 commit 7c94037

File tree

4 files changed

+406
-152
lines changed

4 files changed

+406
-152
lines changed

Documentation/Installation/Index.rst

Lines changed: 51 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,35 @@
1+
:navigation-title: Installation
2+
13
.. include:: /Includes.rst.txt
4+
.. _installation_index:
25

3-
.. index:: installation
6+
=====================================
7+
Prepare / Install local TYPO3 project
8+
=====================================
49

5-
.. _installation_index:
10+
Setting up your local TYPO3 project requires a few simple steps.
11+
This chapter will guide you through preparing your development environment,
12+
installing TYPO3, and getting ready to build your first website.
13+
14+
The rest of the Getting Started guide assumes that TYPO3 has been installed locally
15+
using DDEV and Composer, as described here.
616

7-
============
8-
Installation
9-
============
17+
If you prefer a to use a different installation method (for example, manual
18+
installation on a server), see the full
19+
`TYPO3 installation guide <https://docs.typo3.org/permalink/t3coreapi:installation-index>`_.
1020

1121
.. toctree::
1222
:hidden:
1323
:titlesonly:
1424

15-
SystemRequirements/Index
16-
Version
25+
UsingDdev
1726
Install
27+
Setup
28+
Version
29+
Updates/Index
1830
DeployTYPO3
1931
ApplicationContext
20-
Updates/Index
32+
SystemRequirements/Index
2133

2234
.. card-grid::
2335
:columns: 1
@@ -26,41 +38,39 @@ Installation
2638
:class: pb-4
2739
:card-height: 100
2840

29-
.. card:: :ref:`System requirements <system-requirements>`
41+
.. card:: :ref:`Using DDEV <ddev>`
3042

31-
System requirements for the host operating system, including its web
32-
server and database and how they should be configured prior to
33-
installation.
43+
Learn how to install, update, and manage DDEV to run your TYPO3
44+
projects locally.
3445

35-
.. card:: :ref:`Version <typo3-version>`
46+
.. card:: :ref:`Installing TYPO3 with DDEV <install>`
3647

37-
This chapter helps you choose the best TYPO3 version to start with and
38-
provides resources for getting it.
48+
Follow a quick and simple guide to install TYPO3 locally using DDEV,
49+
Docker, and Composer.
3950

40-
.. card:: :ref:`Installing TYPO3 <install>`
51+
.. card:: :ref:`Setting up TYPO3 after installation <typo3-setup>`
4152

42-
This is a step-by-step guide detailing how to install TYPO3 for local
43-
development using DDEV, Docker and Composer.
53+
Complete TYPO3 setup by creating an admin user and configuring
54+
initial options.
4455

45-
.. card:: :ref:`TYPO3 Updates <getting-started-typo3-updates>`
56+
.. card:: :ref:`Choosing a TYPO3 version <typo3-version>`
4657

47-
Here we explain the cycle of TYPO3 updates, and show you why and when
48-
a TYPO3 update is useful.
58+
Find out which TYPO3 version to start with and where to get it.
4959

50-
.. card:: :ref:`Deploying TYPO3 <DeployTYPO3>`
60+
.. card:: :ref:`Keeping TYPO3 up to date <getting-started-typo3-updates>`
5161

52-
After you have installed TYPO3 locally, learn how to move your result
53-
to a web server.
62+
Learn about TYPO3 update cycles and how to keep your installation secure
63+
and up to date.
5464

55-
.. card:: :ref:`Application context <application-context>`
65+
.. card:: :ref:`Deploying TYPO3 to a server <DeployTYPO3>`
5666

57-
Use the TYPO3 application context to manage settings for
58-
development and production.
67+
Learn how to move your TYPO3 project from your local DDEV environment
68+
to a live web server.
5969

6070
.. _installation_advanced:
6171

6272
Advanced installation topics
63-
============================
73+
=============================
6474

6575
.. card-grid::
6676
:columns: 1
@@ -69,7 +79,17 @@ Advanced installation topics
6979
:class: pb-4
7080
:card-height: 100
7181

72-
.. card:: :ref:`Tuning TYPO3 <t3coreapi:TuneTYPO3>`
82+
.. card:: :ref:`Application context <application-context>`
83+
84+
Use the TYPO3 application context to manage different settings for
85+
development, testing, and production.
86+
87+
.. card:: `System Requirements <https://docs.typo3.org/permalink/t3coreapi:system-requirements>`_
88+
89+
If you want to install TYPO3 manually or deploy to a production server, check
90+
the full system requirements for PHP, database, and web server.
91+
92+
.. card:: `Tuning TYPO3 <https://docs.typo3.org/permalink/t3coreapi:tunetypo3>`_
7393

74-
This chapter in TYPO3 Explained contains information on how to configure and optimize the
75-
infrastructure running TYPO3.
94+
Learn how to configure, optimize, and fine-tune the infrastructure
95+
running TYPO3 for better performance and scalability.

0 commit comments

Comments
 (0)