Fixed description for library

laravelsu · Apr 26, 2024 · 61fbfa2 · 61fbfa2
1 parent 429f4f5
commit 61fbfa2
Show file tree

Hide file tree

Showing 11 changed files with 44 additions and 26 deletions.
diff --git a/resources/views/library/clear-code.blade.php b/resources/views/library/clear-code.blade.php
@@ -7,7 +7,7 @@
         <x-slot name="sup">Чистый код</x-slot>
         <x-slot name="title">Простые правила для вашего кода</x-slot>
         <x-slot name="description">
-            Код должен быть понятен всем членам команды и легко читаем для разработчиков, которые могут внести изменения в него
+            Код должен быть понятен всем членам команды и легко читаем для разработчиков, которые могут внести изменения в него.
         </x-slot>
         <x-slot name="content">
             {{--

diff --git a/resources/views/library/how-to-ask.blade.php b/resources/views/library/how-to-ask.blade.php
@@ -7,7 +7,7 @@
         <x-slot name="sup">Ааа, помогите, ничего не работает</x-slot>
         <x-slot name="title">Как задавать вопросы?</x-slot>
         <x-slot name="description">
-            Правильно заданный вопрос содержит половину ответа
+            Правильно заданный вопрос содержит половину ответа.
         </x-slot>
         <x-slot name="content">
             <figure class="d-none d-md-block">

diff --git a/resources/views/library/security.blade.php b/resources/views/library/security.blade.php
@@ -7,7 +7,7 @@
         <x-slot name="sup">Разработчикам</x-slot>
         <x-slot name="title">Советы по безопасности</x-slot>
         <x-slot name="description">
-            Распространенные ошибки в коде, приводящие к уязвимостям безопасности в приложениях на Laravel
+            Распространенные ошибки в коде, приводящие к уязвимостям безопасности в приложениях на Laravel.
         </x-slot>
         <x-slot name="content">
             <figure class="d-none d-md-block">

diff --git a/resources/views/library/upgrade.blade.php b/resources/views/library/upgrade.blade.php
@@ -9,7 +9,7 @@
 
         <x-slot:description>
             У любого программного обеспечения есть жизненный цикл,
-            которого необходимо придерживаться
+            которого необходимо придерживаться.
         </x-slot>
 
         <x-slot:content >

diff --git a/storage/library/how-to-ask/clarity.md b/storage/library/how-to-ask/clarity.md
@@ -1,10 +1,8 @@
 ---
 title: 'Конкретика'
-description: 'Имена должны быть информативными и отражать суть того, что они представляют.'
+description: 'Не пиши <mark>не работает</mark>, <mark>кидает ошибку</mark>, <mark>не помогло</mark>. Пиши конкретно что происходит и что ты делал.'
 ---
 
-Не пиши не работает, кидает ошибку, не помогло
-
 Объясняй подробно, что происходит, какая ошибка, показывай итоговый код.
 
 Не используй местоимения, говори всегда конкретно, потому что часто сложно понять о чем идёт речь, когда сообщение

diff --git 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
@@ -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
@@ -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
@@ -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
@@ -3,4 +3,5 @@ title: 'Показывай как есть'
 description: 'Имена должны быть информативными и отражать суть того, что они представляют.'
 ---
 
-Никогда не изменяй код который отправляешь в чат, всегда отправляй то, что запускаешь. Популярная проблема: тестируется один код, а в чат присылается другой, в результате время людей потрачено в пустую, а ты будешь реже получать ответы.
+Никогда не изменяй код который отправляешь в чат, всегда отправляй то, что запускаешь. Популярная проблема: тестируется
+один код, а в чат присылается другой, в результате время людей потрачено в пустую, а ты будешь реже получать ответы.
diff --git a/storage/library/how-to-ask/why.md b/storage/library/how-to-ask/why.md
@@ -6,8 +6,14 @@ description: '«Дай голодному рыбу - и ты накормишь
 
 Чат не гугл, потому что гугл - это гугл. Ваш Кэп.
 
-Чат нужен не для простых вопросов-ответов, а для того, чтобы более опытные разработчики помогли научиться решать проблемы, внести ясность в тему, а не просто давали тебе готовые ответы. Также чат нужен для сбора мнений, дискуссий и оценок.
+Чат нужен не для простых вопросов-ответов, а для того, чтобы более опытные разработчики помогли научиться решать
+проблемы, внести ясность в тему, а не просто давали тебе готовые ответы. Также чат нужен для сбора мнений, дискуссий и
+оценок.
 
-Разработка - это не только алгоритмический процесс по инструкциям, разработка - это ещё и творчество, которое требует соответствующего мышления.
+Разработка - это не только алгоритмический процесс по инструкциям, разработка - это ещё и творчество, которое требует
+соответствующего мышления.
 
-Если тебе задают вопросы вместо ответа, то попробуй погуглить их или поразмышлять над ними в чате, потому что такие вопросы являются наводящими. Дать тебе прямой ответ часто бесполезно, ибо смысл научиться думать самостоятельно. И в дальнейшем ты должен начать задавать такие наводящие вопросы самому себе и таким образом научиться самостоятельно находить способы решения задач и проблем.
+Если тебе задают вопросы вместо ответа, то попробуй погуглить их или поразмышлять над ними в чате, потому что такие
+вопросы являются наводящими. Дать тебе прямой ответ часто бесполезно, ибо смысл научиться думать самостоятельно. И в
+дальнейшем ты должен начать задавать такие наводящие вопросы самому себе и таким образом научиться самостоятельно
+находить способы решения задач и проблем.