Conversation
marss-hub
requested review from
HellSquirrel,
Inventoris,
ra1nbow1 and
vitya-ne
as code owners
github-actions
bot
added
js
|
@marss-hub Привет! |
@vitya-ne Привет! Спасибо за комментарии, добавила по ним в доку еще немного информации |
There was a problem hiding this comment.
Светлана привет! Витя и Матвей посмотрели пиар, а значит самое время набежать и мне)
Смотри, это большая работа, и ты взяла очень сложную тему (что крайне круто). Поэтому сразу предупрежу: зафиналить такой текст нелегко. Но я постараюсь с этим помочь =)
У нас есть вот такое руководство по стилю. Очень прошу тебя посмотреть на три главных момента в тексте:
- Очень сложно. Дока это тексты, которые можно начать с "Короче, эта штука делает...". Сейчас текст больше похож на серьезную документацию, Дока старается от этого уйти.
- Посмотри пожалуйста на блок документации "текст утяжеляют". Нужно убрать все такие вещи, в первую очередь диепричастия, вроде "задавая" итд.
- Есть орфографические ошибки, посмотри на текст ещё разок. Местами потерялись запятые.
Если тебе тяжело это сделать, нет времени или желания, можно попросить ChatGPT отредактировать текст, скормив ему в качестве примера одну из док Алёны, например.
Ах да, уверен блок "Как понять" тут не помешает, давай его тоже добавим, чтобы была структура доки.
Привет Алексей! Спасибо за четкую формулировку необходимых доработок для финализации. Я доработала текст:
Надеюсь, он стал лучше ;) |
|
Внесла правки в стиль и структуру доки |
Внесла правки, по комментам отписалась. Жду нового ревью, глянь пожалуйста. |
Inventoris
left a comment
Inventoris
left a comment
There was a problem hiding this comment.
Отлично ƪ(˘⌣˘)ʃ
Оставил один коммент снизу, а так апрув)
P.S. Возможно, кто-то из нашей команды может набежать с правками, будь готова. Но может и не набежать, думаю, основное уже ок.
HellSquirrel
left a comment
HellSquirrel
left a comment
There was a problem hiding this comment.
Замечательная дока! Спасибо большое за PR. Я добавила несколько предложений и коментов
|
@Inventoris без тебя тут не обойтись 🆘 Мы с тобой существенно упростили первоначально предложенный мной вариант статьи, и мне не хотелось бы возвращаться к усложнению и добавлению информации, которая снова может оказаться избыточной. И, как следствие, не очень ясно, в каких моментах указанных в правках, стоит расширять статью (и углубляться), а в каких она достаточна.. |
|
@Inventoris маякни пожалуйста - мне лучше дождаться твоих комментов или начинать править на своё усмотрение? |
|
@marss-hub |
вот здесь мы что-то с переносом делали уже. |
Хмм.. Конечно немного странно, если блоки приходиться двигать дважды...
|
Я согласна что |
Я за перенос в 'Как понять'. |
Отлично! Перенесла |
Превью контента из a8c9a48 опубликовано. |
|
Всем привет! Хотела узнать как дела с аппрувом доки, а то как застопорилось всё.. |
HellSquirrel
left a comment
HellSquirrel
left a comment
There was a problem hiding this comment.
Очень круто! Давай немножко улучшим часть про порядок и адресацию
| const buffer = new Uint8Array([0, 42, 0, 42]).buffer | ||
| const dataView = new DataView(buffer) | ||
|
|
||
| // Читаем 8-битное число с позиции 0 |
There was a problem hiding this comment.
Давай уточним что мы читаем Uint8 - это беззнаковое число. Разница важна для отричательных чисел (здесь и далее)
|
|
||
| ### Указание порядка байтов | ||
|
|
||
| _Порядок байтов (endianness)_ — это последовательность байтов которая используется для хранения чисел в памяти. По умолчанию `DataView` использует порядок от старшего к младшему (_big-endian_). Подробнее о памяти можно узнать из статьи «[Как устроена память](/tools/trivial-memory-model/)». |
There was a problem hiding this comment.
Давай попробуем уточнить тут определение - это не последовательность которая используется для хранения. Хранится все одно и тоже. Это то как это последователльность интерпретируется (адресуется). [0x01, 0x02] - 0x0102 = 258 vs 0x0201 = 513
|
|
||
| _Порядок байтов (endianness)_ — это последовательность байтов которая используется для хранения чисел в памяти. По умолчанию `DataView` использует порядок от старшего к младшему (_big-endian_). Подробнее о памяти можно узнать из статьи «[Как устроена память](/tools/trivial-memory-model/)». | ||
|
|
||
| `DataView` позволяет явно указать порядок байтов т. к. принимает флаг little-endian при чтении или записи. В обычных типизированных массивах такой возможности нет. Это особенно важно, когда порядок байтов в данных отличается от порядка, используемого в операционной системе. |
There was a problem hiding this comment.
Тут тоже не совсем понятно. Но я предположу что имеется ввиду - мы читаем какой-то внешний источник и он предпологает один тип адресации и этот тип отличается от адресации в os
5 participants
Описание
Дополняю статью о
DataViewПревью: https://content-5888.dev.doka.guide/js/data-view/
Closes #4793
Чек-лист
/css/color/,/tools/json/,/tools/gulp/#kak-ponyat)images/example.png,demos/example/,../demos/example/)