docs: restructures installation and moves legacy setups

[lasomethingsomething]

This PR reflects a product decision to highlight Docker as our primary installation method. Documentation about other methods remains, and is now stored in a separate folder.

Edits divide software requirements from hardware requirements.

The main page includes a line that takes users directly to the install section.

[github-actions]

⚠️ Moved markdown files detected. Please ensure redirects are updated in .gitbook.yaml file.

[sushmangupta]

I have suggested changes to some sections so far. Let me know if we have to proceed this way, or if I can make the changes directly to your branch ?

[sushmangupta]

Push this file content into index.md file.

[sushmangupta]

Suggested change

Our setup is based on [Docker](https://www.docker.com/), a platform that enables developers to develop, ship, and run applications inside containers: lightweight, standalone, and executable packages. Docker enables production-like conditions consistent across teams and CI/CD, and makes it easy to reset or rebuild environments (`docker compose down -v`). When you need you need full service parity (e.g. caching, queues, search), Docker shines.

The Shopware 6 development environment is primarily supported and recommended to be used with [Docker](https://www.docker.com/). This platform enables developers to develop, ship, and run applications inside containers: lightweight, standalone, and executable packages. Docker enables production-like conditions consistent across teams and CI/CD, and makes it easy to reset or rebuild environments. Docker is especially useful when full service parity is required (e.g., caching, queues, search).

[sushmangupta]

Suggested change

	Our [Docker setup](./docker-setup.md) aims to provide a smooth onboarding experience aligned with modern development practices. It runs your entire Shopware environment in containers, including all backend services (PHP, MySQL, Node, an Elasticsearch-compatible search engine, Redis, Mailhog, etc.). No manual installation required.
	The [Docker-based setup](./docker-setup.md) aims to provide a smooth onboarding experience aligned with modern development practices. It runs your entire Shopware environment in containers, including all backend services (PHP, MySQL, Node, an Elasticsearch-compatible search engine, Redis, Mailhog, etc.). No manual installation is required.

[sushmangupta]

Suggested change

	The pages that follow assume that you're using Docker itself. That said, the Shopware community has produced some related tooling for developers who prefer more automated or GUI-friendly ways to run Docker environments: DDEV and Dockware. Both are **community-maintained** and not officially supported by Shopware.
	The pages that follow assume that you're using Docker itself.
	Shopware community has produced some related tooling for developers who prefer more automated or GUI-friendly ways to run Docker environments: [DDEV](#DDEV) and Dockware(#Dockware setup). Both are **community-maintained** and not officially supported by Shopware.

[sushmangupta]

:::info
The installation workflow has been streamlined to focus on a Docker-based setup as the primary approach. Previous methods are available in the Legacy Setups section.
:::

[sushmangupta]

Suggested change

	Project creation takes a few minutes to complete. In your terminal, this prompt will eventually appear:
	Project creation takes a few minutes to complete. When prompted in the terminal, you will see::

[sushmangupta]

Suggested change

	**Tip:** You can check container status anytime with:
	:::info
	You can check the container status anytime with the below command
	:::

[sushmangupta]

If the service status doesn't show "Healthy", then how do we proceed?

[sushmangupta]

Suggested change

	What happens during `make setup`:
	- The Makefile runs the Shopware installer inside the web container
	- Shopware is installed automatically (no browser wizard required)
	- A MariaDB database is created
	- An admin user is created, with username `admin` and password `shopware`
	- Required services (database, search, mail, etc.) are running inside Docker and already configured
	- The Shopware project is configured to connect to the database via the Docker service name `database`
	- Database credentials are defined in the `compose.yaml`
	- If search was enabled during project creation, an Elasticsearch-compatible search service runs as part of the Docker stack
	:::info
	What happens during `make setup`:
	- The Makefile runs the Shopware installer inside the web container
	- Shopware is installed automatically (no browser wizard required)
	- A MariaDB database is created
	- An admin user is created, with username `admin` and password `shopware`
	- Required services (database, search, mail, etc.) are preconfigured and runs inside the Docker
	- The Shopware project is configured to connect to the database via the Docker service name `database`
	- Database credentials are defined in the `compose.yaml`
	- If search was enabled during project creation, an Elasticsearch-compatible search service runs as part of the Docker stack
	:::

[sushmangupta]

Suggested change

	You verify the installation succeeded by opening <http://localhost:8000>.
	Use `make up` and `make down` to start or stop your environment. Use `docker compose down -v` to fully reset it. The `-v` flag deletes the containers, networks, and volumes, meaning all stored data will be lost.
	On the next page, we'll help you to start developing.
	Verify that the installation completed successfully by opening <http://localhost:8000>.
	Use the following commands to manage the development environment:
	```bash
	# Start the environment
	make up
	# Stop the environment
	make down
	# Fully reset the environment ( "-v" flag removes containers, networks, and volumes - all stored data will be lost)
	docker compose down -v

Proceed to the next section to begin development.

[sushmangupta]

I have suggested changes to some sections so far. Let me know if we have to proceed this way, or if I can make the changes directly to your branch ?