diff --git a/resources/views/library/clear-code.blade.php b/resources/views/library/clear-code.blade.php index 69cf226c..19333dc0 100644 --- a/resources/views/library/clear-code.blade.php +++ b/resources/views/library/clear-code.blade.php @@ -7,7 +7,7 @@ Чистый код Простые правила для вашего кода - Код должен быть понятен всем членам команды и легко читаем для разработчиков, которые могут внести изменения в него + Код должен быть понятен всем членам команды и легко читаем для разработчиков, которые могут внести изменения в него. {{-- diff --git a/resources/views/library/how-to-ask.blade.php b/resources/views/library/how-to-ask.blade.php index f5b586d6..8653b270 100644 --- a/resources/views/library/how-to-ask.blade.php +++ b/resources/views/library/how-to-ask.blade.php @@ -7,7 +7,7 @@ Ааа, помогите, ничего не работает Как задавать вопросы? - Правильно заданный вопрос содержит половину ответа + Правильно заданный вопрос содержит половину ответа.
diff --git a/resources/views/library/security.blade.php b/resources/views/library/security.blade.php index d0f4a515..17b2927a 100644 --- a/resources/views/library/security.blade.php +++ b/resources/views/library/security.blade.php @@ -7,7 +7,7 @@ Разработчикам Советы по безопасности - Распространенные ошибки в коде, приводящие к уязвимостям безопасности в приложениях на Laravel + Распространенные ошибки в коде, приводящие к уязвимостям безопасности в приложениях на Laravel.
diff --git a/resources/views/library/upgrade.blade.php b/resources/views/library/upgrade.blade.php index 9d600eba..4bd3e320 100644 --- a/resources/views/library/upgrade.blade.php +++ b/resources/views/library/upgrade.blade.php @@ -9,7 +9,7 @@ У любого программного обеспечения есть жизненный цикл, - которого необходимо придерживаться + которого необходимо придерживаться. diff --git a/storage/library/how-to-ask/clarity.md b/storage/library/how-to-ask/clarity.md index 4a245bca..6b7eb22b 100644 --- a/storage/library/how-to-ask/clarity.md +++ b/storage/library/how-to-ask/clarity.md @@ -1,10 +1,8 @@ --- title: 'Конкретика' -description: 'Имена должны быть информативными и отражать суть того, что они представляют.' +description: 'Не пиши не работает, кидает ошибку, не помогло. Пиши конкретно что происходит и что ты делал.' --- -Не пиши не работает, кидает ошибку, не помогло - Объясняй подробно, что происходит, какая ошибка, показывай итоговый код. Не используй местоимения, говори всегда конкретно, потому что часто сложно понять о чем идёт речь, когда сообщение diff --git a/storage/library/how-to-ask/do-not-worry.md b/storage/library/how-to-ask/do-not-worry.md index f9a2d76f..563c8bd2 100644 --- a/storage/library/how-to-ask/do-not-worry.md +++ b/storage/library/how-to-ask/do-not-worry.md @@ -1,9 +1,12 @@ --- title: 'Не нервничай' -description: 'Имена должны быть информативными и отражать суть того, что они представляют.' +description: 'Будь взрослее, тебе никто ничего не должен.' --- +Если тебя отправляют в гугл или в доку, то ты должен понимать, что ты задаёшь очень примитивные вопросы, которые мог бы +решить и сам, не психуй, а прими к сведению. Если ты гуглил, а тебе говорят "погугли", попроси точную формулировку +запроса, гуглить тоже надо уметь. Если тебе отвечают незнакомым словом, не спеши сразу спрашивать "что это?", а +разберись в теме сам. -Если тебя отправляют в гугл или в доку, то ты должен понимать, что ты задаёшь очень примитивные вопросы, которые мог бы решить и сам, не психуй, а прими к сведению. Если ты гуглил, а тебе говорят "погугли", попроси точную формулировку запроса, гуглить тоже надо уметь. Если тебе отвечают незнакомым словом, не спеши сразу спрашивать "что это?", а разберись в теме сам. - -Не огрызайся и не отвечай на токсичные сообщения, тем более не переходи на личности. В вопросе тебе это не поможет, а "mute" получишь ты. Будь взрослее, тебе никто ничего не должен. +Не огрызайся и не отвечай на токсичные сообщения, тем более не переходи на личности. В вопросе тебе это не поможет, а " +mute" получишь ты. Будь взрослее, тебе никто ничего не должен. diff --git a/storage/library/how-to-ask/drafting.md b/storage/library/how-to-ask/drafting.md index 1184c979..42cac92a 100644 --- a/storage/library/how-to-ask/drafting.md +++ b/storage/library/how-to-ask/drafting.md @@ -3,11 +3,18 @@ title: 'Формулировка' description: 'Не пиши сразу в чат по любой проблеме. Сформулируй вопрос в блокноте.' --- -Напиши вопрос, прочти его (можешь вслух), подумай -всё ли ты учёл, правильно ли ты донёс свою мысль, могут ли тебя понять иначе. Это называется «Метод утёнка» , суть -которого проговорить вопрос или проблему, вслух или письменно. +**Напиши вопрос, прочти его (можешь вслух), подумай:** +- Всё ли ты учёл? +- Правильно ли ты донёс свою мысль? +- Могут ли тебя понять иначе? -Попробуй сократить текст, чтобы было максимум смысла и минимум слов. +Это называется «Метод утёнка», суть которого проговорить вопрос или проблему, вслух или письменно. Попробуй сократить +текст, чтобы было максимум смысла и минимум слов. -А теперь погугли ключевые слова из своего вопроса. Ничего не нашёл? Измени ключевые слова, уточни их. Опять ничего? -Воспользуйся поиском по чату, многие проблемы уже обсуждались и не единожды. Не нашёл? Теперь задавай вопрос в чат. +**А теперь погугли ключевые слова из своего вопроса.** +- Ничего не нашёл? +- Измени ключевые слова, уточни их. +- Опять ничего? +- Воспользуйся поиском по чату, многие проблемы уже обсуждались и не единожды. +- Не нашёл? +- Теперь задавай вопрос в чат. diff --git a/storage/library/how-to-ask/full-screen.md b/storage/library/how-to-ask/full-screen.md index 379070a7..0f45967b 100644 --- a/storage/library/how-to-ask/full-screen.md +++ b/storage/library/how-to-ask/full-screen.md @@ -1,8 +1,9 @@ --- title: 'Полные скриншоты' -description: 'Имена должны быть информативными и отражать суть того, что они представляют.' +description: 'Не надо стеснятся своего кода' --- -Прикрепляй к сообщению полные скриншоты кода и ошибок, не обрезай их. Часто самое важное почему-то игнорируется, не надо стеснятся своего кода или неймингов, конфиденциальные данные закрась. Большие куски кода или логов загружай на -pastebin +Прикрепляй к сообщению полные скриншоты кода и ошибок, не обрезай их. Часто самое важное почему-то игнорируется, не надо +стеснятся своего кода или неймингов, конфиденциальные данные закрась. Большие куски кода или логов загружай на +[pastebin](https://laravel.su/pastebin), а ссылку на них прикрепляй к сообщению. diff --git a/storage/library/how-to-ask/only-public.md b/storage/library/how-to-ask/only-public.md index be93db75..9d6aae17 100644 --- a/storage/library/how-to-ask/only-public.md +++ b/storage/library/how-to-ask/only-public.md @@ -1,6 +1,8 @@ --- title: 'Только общий чат' -description: 'Имена должны быть информативными и отражать суть того, что они представляют.' +description: 'Тебя могут научить плохим практикам и ты об этом не узнаешь!' --- -Не пиши в личку, продолжай общаться в общем чате. Не стесняйся и не бойся критики, важно мнение большинства, а не одного человека. Если отвечающий не прав, то кто-то вмешается и укажет на это, а в личке тебя научат bad-практикам и ты об этом не узнаешь. Как минимум правильных решений может быть несколько, в чем и заключается преимущество чатов. +Не пиши в личку, продолжай общаться в общем чате. Не стесняйся и не бойся критики, важно мнение большинства, а не одного +человека. Если отвечающий не прав, то кто-то вмешается и укажет на это, а в личке тебя научат bad-практикам и ты об этом +не узнаешь. Как минимум правильных решений может быть несколько, в чем и заключается преимущество чатов. diff --git a/storage/library/how-to-ask/show-really.md b/storage/library/how-to-ask/show-really.md index 3af51ac4..04048ade 100644 --- a/storage/library/how-to-ask/show-really.md +++ b/storage/library/how-to-ask/show-really.md @@ -3,4 +3,5 @@ title: 'Показывай как есть' description: 'Имена должны быть информативными и отражать суть того, что они представляют.' --- -Никогда не изменяй код который отправляешь в чат, всегда отправляй то, что запускаешь. Популярная проблема: тестируется один код, а в чат присылается другой, в результате время людей потрачено в пустую, а ты будешь реже получать ответы. +Никогда не изменяй код который отправляешь в чат, всегда отправляй то, что запускаешь. Популярная проблема: тестируется +один код, а в чат присылается другой, в результате время людей потрачено в пустую, а ты будешь реже получать ответы. diff --git a/storage/library/how-to-ask/why.md b/storage/library/how-to-ask/why.md index 36fc643c..3211f67a 100644 --- a/storage/library/how-to-ask/why.md +++ b/storage/library/how-to-ask/why.md @@ -6,8 +6,14 @@ description: '«Дай голодному рыбу - и ты накормишь Чат не гугл, потому что гугл - это гугл. Ваш Кэп. -Чат нужен не для простых вопросов-ответов, а для того, чтобы более опытные разработчики помогли научиться решать проблемы, внести ясность в тему, а не просто давали тебе готовые ответы. Также чат нужен для сбора мнений, дискуссий и оценок. +Чат нужен не для простых вопросов-ответов, а для того, чтобы более опытные разработчики помогли научиться решать +проблемы, внести ясность в тему, а не просто давали тебе готовые ответы. Также чат нужен для сбора мнений, дискуссий и +оценок. -Разработка - это не только алгоритмический процесс по инструкциям, разработка - это ещё и творчество, которое требует соответствующего мышления. +Разработка - это не только алгоритмический процесс по инструкциям, разработка - это ещё и творчество, которое требует +соответствующего мышления. -Если тебе задают вопросы вместо ответа, то попробуй погуглить их или поразмышлять над ними в чате, потому что такие вопросы являются наводящими. Дать тебе прямой ответ часто бесполезно, ибо смысл научиться думать самостоятельно. И в дальнейшем ты должен начать задавать такие наводящие вопросы самому себе и таким образом научиться самостоятельно находить способы решения задач и проблем. +Если тебе задают вопросы вместо ответа, то попробуй погуглить их или поразмышлять над ними в чате, потому что такие +вопросы являются наводящими. Дать тебе прямой ответ часто бесполезно, ибо смысл научиться думать самостоятельно. И в +дальнейшем ты должен начать задавать такие наводящие вопросы самому себе и таким образом научиться самостоятельно +находить способы решения задач и проблем.