Size: a a a

CODE BLOG / Чат

2021 July 25

mF

mr. Fox in CODE BLOG / Чат
?
источник

J

Jmik in CODE BLOG / Чат
если этого достаточно — да
Зачем мне раздел про то, что мне не важно в данный момент
источник

mF

mr. Fox in CODE BLOG / Чат
Я ещё не видел документ где тебя бы (по твоей логике работы) не бросал в самое начало книги...
То есть : открвл разрел на странице Х а тебя потом возвращает на страницу 3 тк без прочтения 109 первых водных страниц просто нельзя понять что ты делаешь...
Поэтому ещё раз вопрос, как ты работаешь с документацией, мы выяснили что читать по 1 страницы не работает, что ещё есть?
источник

J

Jmik in CODE BLOG / Чат
вот такой документ: https://gcc.gnu.org/onlinedocs/gccint/index.html
источник

mF

mr. Fox in CODE BLOG / Чат
Ок, кроме этого
источник

J

Jmik in CODE BLOG / Чат
так в любом случае, если на странце Х сказано, что вам небходимыв знания со страниц
А-Б, то в чем проблемма пойти их и прочитать
источник

mF

mr. Fox in CODE BLOG / Чат
Тогда вопрос, как работать с документацией?
То есть : вот раздел Х, чтобы его понять тебе нужно прочесть все от 1 страницы до раздела Х...
Перечитать документ с 0 это не спрособ
источник

J

Jmik in CODE BLOG / Чат
тут тоже хорошая дока https://core.telegram.org/
источник

J

Jmik in CODE BLOG / Чат
Если дока просит чтоб ты прочитал ее от А до Б, то скорее всего это надо сделать
источник

mF

mr. Fox in CODE BLOG / Чат
Я имею ввиду, другое...
Тот случай когда документ писала немронка для неиронки
источник

mF

mr. Fox in CODE BLOG / Чат
Это просит любая дока
источник

mF

mr. Fox in CODE BLOG / Чат
Ххх
источник

mF

mr. Fox in CODE BLOG / Чат
Чувак, ну так есть способ или нет?
источник

mF

mr. Fox in CODE BLOG / Чат
Серьёзно
источник

J

Jmik in CODE BLOG / Чат
пример можно?
в большинстве либо есть раздел "Базовые понятия"
либо конкретно это — плохая дока
источник

mF

mr. Fox in CODE BLOG / Чат
Значит я работал с такими
источник

4

4g in CODE BLOG / Чат
Вы начали спор интересно конечно. Но главный вопрос это то как составляется документация на что-то.
Чем сложнее и многогранее вопрос тем соответственно сложнее документация. Но это не значит что документация будет написана понятно для всех.
Есть вещи которые крайне трудно формализовать в некие правила. Можно, но тогда эту документацию вы не получите в обозримом будущем.
Хватило уже того что многих обязали уйти от main-slave. Что от этого простого шага, который решается обычной find-replace, получило сообщество - ничего серьезного.
Так и от составления документа как надо писать документацию и в дополнение как ее потом читать будет хуже всем.
Любая книга-документация (ну или почти любая) начинается с введения, также принято снабжать оглавлением и индексом терминов и понятий, для удобного поиска.
Если человек не может читать документацию, то видимо у него недостаточный уровень и стоит изучить базовые вещи начиная со школьного букваря и поднимаясь выше и выше. В некоторых случаях как кода упоминалось есть рекомендации для уровня в освоении книги и их достаточно для освоения книги. Достаточно, но это не значит что материал книги будет усвоен
источник

NK

ID:0 in CODE BLOG / Чат
Еще такие счастливые...

#ithumor
источник

D

Dagon in CODE BLOG / Чат
Народ, как считаете для такой сборки цена в 15к адекватна?
источник

DB

Daniil Borin in CODE BLOG / Чат
Да
источник