Skip to content

Commit 488f6a3

Browse files
tabunatabuna
committed
Adedd "How to ask" sections for library
1 parent 8497c47 commit 488f6a3

File tree

9 files changed

+115
-0
lines changed

9 files changed

+115
-0
lines changed

‎resources/views/library/how-to-ask.blade.php

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
@extends('layout')
2+
@section('title', 'Как задавать вопросы?')
3+
@section('description', 'Правильно заданный вопрос содержит половину ответа')
4+
@section('content')
5+
6+
<x-header align="align-items-end">
7+
<x-slot name="sup">Ааа, помогите, ничего не работает</x-slot>
8+
<x-slot name="title">Как задавать вопросы?</x-slot>
9+
<x-slot name="description">
10+
Правильно заданный вопрос содержит половину ответа
11+
</x-slot>
12+
<x-slot name="content">
13+
<figure class="d-none d-md-block">
14+
<x-icon path="l.dots" class="text-primary opacity-2 d-block mx-auto" height="300" width="300"/>
15+
</figure>
16+
</x-slot>
17+
</x-header>
18+
19+
@php
20+
$sections = collect([
21+
'drafting',
22+
'gist',
23+
'clarity',
24+
'full-screen',
25+
'show-really',
26+
'do-not-worry',
27+
'only-public',
28+
'why',
29+
])
30+
->map(fn ($file) => \Illuminate\Support\Str::of($file)->start('how-to-ask/'))
31+
->map(fn ($file) => new \App\Library($file));
32+
@endphp
33+
34+
@include('particles.library-section', ['sections' => $sections])
35+
36+
@endsection

‎storage/library/how-to-ask/clarity.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
title: 'Конкретика'
3+
description: 'Имена должны быть информативными и отражать суть того, что они представляют.'
4+
---
5+
6+
Не пиши не работает, кидает ошибку, не помогло
7+
8+
Объясняй подробно, что происходит, какая ошибка, показывай итоговый код.
9+
10+
Не используй местоимения, говори всегда конкретно, потому что часто сложно понять о чем идёт речь, когда сообщение
11+
состоит из "он", "оно", "это", "этот", "тот".
12+
13+
Чем больше ты заставляешь из тебя вытаскивать информацию и задавать уточняющие вопросы, тем меньше людей будет
14+
продолжать тратить на тебя время. Будь продуктивен, давай всю информацию сам, а не жди пока тебя попросят скинуть скрин
15+
ошибки или показать код, ибо это нужно только тебе.

‎storage/library/how-to-ask/do-not-worry.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
title: 'Не нервничай'
3+
description: 'Имена должны быть информативными и отражать суть того, что они представляют.'
4+
---
5+
6+
7+
Если тебя отправляют в гугл или в доку, то ты должен понимать, что ты задаёшь очень примитивные вопросы, которые мог бы решить и сам, не психуй, а прими к сведению. Если ты гуглил, а тебе говорят "погугли", попроси точную формулировку запроса, гуглить тоже надо уметь. Если тебе отвечают незнакомым словом, не спеши сразу спрашивать "что это?", а разберись в теме сам.
8+
9+
Не огрызайся и не отвечай на токсичные сообщения, тем более не переходи на личности. В вопросе тебе это не поможет, а "mute" получишь ты. Будь взрослее, тебе ни кто ничего не должен.

‎storage/library/how-to-ask/drafting.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: 'Формулировка'
3+
description: 'Не пиши сразу в чат по любой проблеме. Сформулируй вопрос в блокноте.'
4+
---
5+
6+
Напиши вопрос, прочти его (можешь вслух), подумай
7+
всё ли ты учёл, правильно ли ты донёс свою мысль, могут ли тебя понять иначе. Это называется «Метод утёнка» , суть
8+
которого проговорить вопрос или проблему, вслух или письменно.
9+
10+
Попробуй сократить текст, чтобы было максимум сути и минимум слов.
11+
12+
А теперь погугли ключевые слова из своего вопроса. Ничего не нашёл? Измени ключевые слова, уточни их. Опять ничего?
13+
Воспользуйся поиском по чату, многие проблемы уже обсуждались и не единожды. Не нашёл? Теперь задавай вопрос в чат.

‎storage/library/how-to-ask/full-screen.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
title: 'Полные скриншоты'
3+
description: 'Имена должны быть информативными и отражать суть того, что они представляют.'
4+
---
5+
6+
7+
Прикрепляй к сообщению полные скриншоты кода и ошибок, не обрезай их. Часто самое важное почему-то игнорируется, не надо стеснятся своего кода или неймингов, конфиденциальные данные закрась. Большие куски кода или логов загружай на
8+
pastebin

‎storage/library/how-to-ask/gist.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
title: 'Переходи к сути'
3+
description: 'Не задавай meta-вопросы <mark>привет</mark>, <mark>помогите</mark>, <mark>есть кто?</mark>. Сразу задавай подробный вопрос.'
4+
---
5+
6+
Не спрашивай, работал ли кто с "xxx" библиотекой или сталкивался ли кто с "xxx" ошибкой. Даже если ни кто не
7+
сталкивался, то опытные разработчики всё равно смогут подсказать в какую сторону двигаться.
8+
9+
Просто задай свой вопрос. Без лишних прелюдий и топтаний вокруг темы.

‎storage/library/how-to-ask/only-public.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: 'Только общий чат'
3+
description: 'Имена должны быть информативными и отражать суть того, что они представляют.'
4+
---
5+
6+
Не пиши в личку, продолжай общаться в общем чате. Не стесняйся и не бойся критики, важно мнение большинства, а не одного человека. Если отвечающий не прав, то кто-то вмешается и укажет на это, а в личке тебя научат bad-практикам и ты об этом не узнаешь. Как минимум правильных решений может быть несколько, в чем и заключается преимущество чатов.

‎storage/library/how-to-ask/show-really.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: 'Показывай как есть'
3+
description: 'Имена должны быть информативными и отражать суть того, что они представляют.'
4+
---
5+
6+
Никогда не изменяй код который отправляешь в чат, всегда отправляй то, что запускаешь. Популярная проблема: тестируется один код, а в чат присылается другой, в результате время людей потрачено в пустую, а ты будешь реже получать ответы.

‎storage/library/how-to-ask/why.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: 'Зачем нужен чат?'
3+
description: '«Дай голодному рыбу - и ты накормишь его на один день. Дай ему удочку, научи его ловить рыбу - и ты накормишь его на всю жизнь»'
4+
---
5+
6+
7+
Чат не гугл, потому что гугл - это гугл. Ваш Кэп.
8+
9+
Чат нужен не для простых вопросов-ответов, а для того, чтобы более опытные разработчики помогли научиться решать проблемы, внести ясность в тему, а не просто давали тебе готовые ответы. Также чат нужен для сбора мнений, дискуссий и оценок.
10+
11+
Разработка - это не только алгоритмический процесс по инструкциям, разработка - это ещё и творчество, которое требует соответствующего мышления.
12+
13+
Если тебе задают вопросы вместо ответа, то попробуй погуглить их или поразмышлять над ними в чате, потому что такие вопросы являются наводящими. Дать тебе прямой ответ часто бесполезно, ибо смысл научиться думать самостоятельно. И в дальнейшем ты должен начать задавать такие наводящие вопросы самому себе и таким образом научиться самостоятельно находить способы решения задач и проблем.

0 commit comments

Comments
 (0)