Progress on getting started

Author: samdark

src/guide/start/creating-project.md

@@ -12,7 +12,7 @@ It can serve as a good starting point for your projects.
 
 You can create a new project from a template using the [Composer](https://getcomposer.org) package manager:
 
-```
+```sh
 composer create-project yiisoft/app your_project
 ```
 
@@ -38,7 +38,7 @@ APP_ENV=dev ./yii serve --port=80
 
 For Docker users, run:
 
-```
+```sh
 make up
 ```
 

src/guide/start/databases.md

@@ -331,19 +331,175 @@ final readonly class PageRepository
         );
     }
 
-    public function delete(string $id): void
+    public function deleteBySlug(string $slug): void
     {
-        $this->connection->createCommand()->delete('{{%page}}', ['id' => $id])->execute();
+        $this->connection->createCommand()->delete('{{%page}}', ['slug' => $slug])->execute();
     }
 }
 ```
 
 ## Actions and routes
 
-You need actions to:
+You need to be able to:
 
 1. List all pages.
 2. View a page.
 3. Delete a page.
 4. Create a page.
 5. Edit a page.
+
+Let's tackle these one by one.
+
+
+### List all pages
+
+Create `src/Web/Page/ListAction.php`:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Web\Page;
+
+use Psr\Http\Message\ResponseInterface;
+use Yiisoft\Yii\View\Renderer\ViewRenderer;
+
+final readonly class ListAction
+{
+    public function __construct(
+        private ViewRenderer $viewRenderer,
+        private PageRepository $pageRepository,
+    )
+    {
+    }
+
+    public function __invoke(): ResponseInterface
+    {
+        return $this->viewRenderer->render(__DIR__ . '/list', [
+            'pages' => $this->pageRepository->findAll(),
+        ]);
+    }
+}
+```
+
+Define list view in `src/Web/Page/list.php`:
+
+```php
+<?php
+use App\Web\Page\Page;
+use Yiisoft\Html\Html;
+
+/** @var iterable<Page> $pages */
+?>
+
+<ul>
+    <?php foreach ($pages as $page): ?>
+    <li>
+        <?= Html::a($page->title, $this->urlGenerator->generate('page/view', ['slug' => $page->slug])) ?>
+    </li>
+    <?php endforeach ?>
+</ul>
+```
+
+### View a page
+
+Create `src/Web/Page/ViewAction.php`:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Web\Page;
+
+use Psr\Http\Message\ResponseFactoryInterface;
+use Psr\Http\Message\ResponseInterface;
+use Yiisoft\Http\Status;
+use Yiisoft\Router\HydratorAttribute\RouteArgument;
+use Yiisoft\Yii\View\Renderer\ViewRenderer;
+
+final readonly class ViewAction
+{
+    public function __construct(
+        private ViewRenderer $viewRenderer,
+        private PageRepository $pageRepository,
+        private ResponseFactoryInterface $responseFactory
+    )
+    {
+    }
+
+    public function __invoke(
+        #[RouteArgument('slug')]
+        string $slug
+    ): ResponseInterface
+    {
+        $page = $this->pageRepository->findOneBySlug($slug);
+        if ($page === null || $page->isDeleted()) {
+            return $this->responseFactory->createResponse(Status::NOT_FOUND);
+        }
+
+        return $this->viewRenderer->render(__DIR__ . '/view', [
+            'page' => $page,
+        ]);
+    }
+}
+```
+
+Now, a template in `src/Web/Page/view.php`:
+
+```php
+<?php
+use App\Web\Page\Page;
+use Yiisoft\Html\Html;
+
+/** @var Page $page */
+?>
+
+<h1><?= Html::encode($page->title) ?></h1>
+
+<p>
+    <?= Html::encode($page->text) ?>
+</p>
+```
+
+### Delete a page
+
+Create `src/Web/Page/DeleteAction.php`:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Web\Page;
+
+use Psr\Http\Message\ResponseFactoryInterface;
+use Psr\Http\Message\ResponseInterface;
+use Yiisoft\Http\Status;
+use Yiisoft\Router\UrlGeneratorInterface;
+
+final readonly class DeleteAction
+{
+    public function __construct(
+        private PageRepository $pageRepository,
+        private ResponseFactoryInterface $responseFactory,
+        private UrlGeneratorInterface $urlGenerator,
+    )
+    {}
+
+    public function __invoke(string $slug): ResponseInterface
+    {
+        $this->pageRepository->deleteBySlug($slug);
+
+        return $this->responseFactory
+            ->createResponse()
+            ->withStatus(Status::PERMANENT_REDIRECT)
+            ->withHeader('Location', $this->urlGenerator->generate('page/list'));
+    }
+}
+```
+
+### Create a page
+
+