laravelrus / docs Goto Github PK

Заметил, что в некоторых местах комментарии в коде переведены на русский, а в некоторых оставлен оригинал. Думаю, было бы не плохо принять единое соглашение и добавить его в инструкцию по переводу.

Лично моё мнение — комментарии в коде должны оставаться на языке оригинала, исключение только в случае, если без перевода совсем не понятно что происходит. Вижу для этого, как минимум, две причины: комментарии в коде на языке отличном от английского являются плохой практикой, а если в документации примеры будут с русскими комментариями, может сложиться мнение что это наоборот хорошо; при работе с кодом, создании файлов с помощью artisan комментарии будут на английском :)

В качестве исключения, можно переводить подобные вещи

    // Validate that a string is exactly 12 characters long...
    'title' => 'size:12';

    // Validate that a provided integer equals 10...
    'seats' => 'integer|size:10';

    // Validate that an array has exactly 5 elements...
    'tags' => 'array|size:5';

    // Validate that an uploaded file is exactly 512 kilobytes...
    'image' => 'file|size:512';

т.к. они, по сути, являются продолжением текста документации.

https://github.com/laravel/docs/blob/5.6/logging.md

http://laravel.su/docs/5.0/migrations

php artisan make:migrate create_users_table --table=users --create
правильно
php artisan make:migration create_users_table --table=users --create

В файле https://github.com/LaravelRUS/docs/blame/8.x/installation.md#L1 требуется поправить номер коммита git 13f770acbfe97eaa2e77534144ab8d4513d04a04
Сейчас egit 13f770acbfe97eaa2e77534144ab8d4513d04a04 с пробелами в начале

Переведу доку по Laravel Homestead
Уведомление, чтобы не делать с кем-то параллельной одной и той же работы.

http://laravel.su/docs/5.4/notifications#mail-notifications

Было бы здорово добиться стандартизации переводов, чтобы они следовали чётко установленным правилам и форматам. В этом нам может помочь https://github.com/DavidAnson/markdownlint который предлагает широкий набор правил для оформления и согласованности.

Например

При использовании два стиля для объявления кода в одном файле будет приводить к ошибке:

Laravel изначально поддерживает работу с SQL Server;
однако, потребуется добавить настройку подключения к БД в конфиге `config/database.php`:

    'sqlsrv' => [
        'driver' => 'sqlsrv',
        'host' => env('DB_HOST', 'localhost'),
        'database' => env('DB_DATABASE', 'forge'),
        'username' => env('DB_USERNAME', 'forge'),
        'password' => env('DB_PASSWORD', ''),
        'charset' => 'utf8',
        'prefix' => '',
    ],

Вы также можете получить низкоуровневый объект PDO
для этого подключения методом `getPdo` на экземпляре подключения:

'''php
$pdo = DB::connection()->getPdo();
'''

Влияние на переменные

К тому же стоит отметить, что markdownlint корректно обрабатывает YAML-префиксы в документах и не признает их нарушением. Пример такого префикса:

---
layout: post
title: Title
---

Мы могли бы добавить это как GitHub Action в этот репозиторий, для новых веток.

Здравствуйте, планируете 6 версию переводить, или это не так важно, как мне кажется?

Сабж: Предлагаю сохранение номеров строк в переводах документации 8.х относительно оригинальных файлов документации.

На мой скромный взгляд, это позволит свободнее ориентироваться в файле и при реализации перевода сразу переходить к нужной строке, а не как сейчас, искать её через Ctrl+f

Перечеркиваются подзаглавия "Поддоменные роуты" и "Префикс пути" — http://joxi.ru/vAWYG38tVGkjmW

Куда же делась ваша команда:

Перевод документации Laravel 8.x, выполненный командой https://rularavel.com

Неактивная ссылка в левом сайдбаре в документации v5.2 ("API")
http://laravel.su/docs/5.2/installation

Переведу доку по Laravel Horizon
Уведомление, чтобы не делать с кем-то параллельной одной и той же работы.

У вас в разделе http://laravel.su/docs/5.2/blade и в других версиях вместо

@parent написано @

конкретно в этом коде:

@section('sidebar')
    @

    <p>This is appended to the master sidebar.</p>
@endsection

Как минимум 1 человека уже запутали.

Добавлю в репозиторий и переведу доку по Laravel Octane
Уведомление, чтобы не делать с кем-то параллельной одной и той же работы.

Переведу доку по HTTP Redirects
Уведомление, чтобы не делать с кем-то параллельной одной и той же работы.

Данные раздел имеет пустой файл (и, соответственно, пустую страницу на сайте перевода) + в разделе "Статус перевода" стоит статус "перевод не требуется". Это баг или страница не нуждается в переводе?