ПО, ЭВМ и АСУ из Таможенного Союза

Информация о пользователе

Привет, Гость! Войдите или зарегистрируйтесь.



О "качестве" текстов

Сообщений 1 страница 5 из 5

1

MihalNik написал(а):

пишу о качестве исходников, не позволяющем читать их со скоростью и в объемах документации

Вообще говоря, даже документацию сложно написать так, чтобы её было удобно и быстро читать. Есть люди, которые занимаются этим десятилетиями (редакторы MSDN например), и тем не менее, глядя на результат их работы хочется плакать.

Поэтому сложно представить, чтобы код могли подготовить и оформить на таком же уровне люди, которых недавно обучили в школе самым основам написания синтаксических конструкций.

Отредактировано Лис (2020-10-08 17:39:03)

0

2

https://habr.com/ru/post/522498/
Вот на хабре примерно о этом же обсуждают.

ПО - как много в этом звуке. 
Пишу мелкие программы.
1. Архитектуру я научился делать.  По книгам и большим опытом.
2. Дробить код на функции тоже пришло с опытом. Теперь для этого есть метрики таксичности.
3. Вести жизненный цикл программы скорее нет чем да. Хотя дзен постиг. Пишешь минимально рабочий проект потом переделываешь небольшими шагами. Каждый шаг должен быть закончен и не приводить к деградации ПО.
4. Пункт 3 невозможен без документации и поддержания её в актуальном состоянии.
5. Дизайн важен нужно делать пошаговое заполнение и обучение пользователя. Нужна контекстная справка либо инфографика. 
6. Исследования и изыскания.
7. Отладка,
8. Тестирование.

И вот встаёт вопрос! Как качественно разрабатывать софт? Если он требует всех этих 8 пунктов? А времени хватает только на 2-3?

Отредактировано Павиа (2020-10-08 23:27:15)

0

3

Поэтому сложно представить, чтобы код могли подготовить и оформить на таком же уровне люди, которых недавно обучили в школе самым основам написания синтаксических конструкций.

В школе не учат писать тексты. Это только в последние годы стала развиваться теория.

0

4

Есть люди, которые занимаются этим десятилетиями (редакторы MSDN например), и тем не менее, глядя на результат их работы хочется плакать.

Раньше писали связный текст одну книгу которую после превращали в справочник. А сейчас справочник превращают в книгу.  В результате имеем клипартное мышление -Тут почитатл, там посмотрел, а текст связано изложить не можем.
Хорошие примеры книг
Turbo Pascal Version 7.0 Language Guide 1992
Borland Turbo Assembler 5.0 User's Guide
win300sdk описание WIN32API в 5 томах. 1993 год

И в 2000 майкрософт много вложило в выпуск книг по внутреннему устройству. Статьи из этих книг попали в справочник MSDN. У нас в универе так лабы проходили по изучению win2k 5 минут постановка задачи 10 минут поиск в интернете информации. Тогда было всё подробно описано и стройно изложено. Сейчас же информации не найти либо все мозги прокепитишь.

Поэтому для создания документации необходим технический писатель.

Отредактировано Павиа (2020-10-08 23:40:00)

0

5

Лис написал(а):

Поэтому сложно представить, чтобы код могли подготовить и оформить на таком же уровне люди, которых недавно обучили в школе самым основам написания синтаксических конструкций.

Обычно вчерашние школьники не должны изготавливать средства производства для остальных. Хотя я и давал ссылку на исключение.
Во-вторых, не всякий язык позволяет писать легко читаемые исходники.

Отредактировано MihalNik (2020-10-08 23:45:18)

0