качественную документацию по ГОСТ любо-дорого читать. Просто ГОСТы в оформлении локументации не всегда нужны. Но в сложных областях, где работают профессионалы - стандартизация очень важна.
Именно так. Наличие стандарта значительно улучшает ваш паттерн-матчинг (можно бюллетень как это нормально по-русски? :)). Требование абсолютной жесткости при этом не нужно, нужно только условно говоря писать заявление о передаче почки нуждающемуся за каждое отклонение от стандарта, которое вы умышленно допускаете.
загонять документацию в рамки некоего стандарта – все равно что усреднять. Супер крутой документации стандарт только мешает быть максимально удобной, но вот супер унылую документацию стандарт может вытащить до удовлетворительного уровня, если ему следовать.
В общем, кажется, мы спорим об одном и том же. У вас должен быть соответствующий уровень квалификации, чтобы отклоняться от стандарта, вы должны быть способны предложить вариант лучше, и очень хорошо понимать его последствия
В общем, кажется, мы спорим об одном и том же. У вас должен быть соответствующий уровень квалификации, чтобы отклоняться от стандарта, вы должны быть способны предложить вариант лучше, и очень хорошо понимать его последствия
Кажется, нам остаётся собрать нужных людей вместе и развести немного бюрократии, чтобы каждый подобный случай обсуждался и, если можно улучшить стандарт, улучшать стандарт. Мы получим хорошо работающую систему (пусть у неё есть известные недостатки), которой при этом очень сложно изначально самоорганизоваться
А вы не слышали анекдот? Собрались как-то ученые и давай обсуждать: Безобразие! У нас 14 разных стандартов в одной области, которые противоречат друг другу! Побузили, составили рабочую группу и разошлись. Через год собрались опять: Безобразие! У нас 15 разных стандартов в одной области, которые противоречат друг другу!
Да всё давно придумано до нас. Есть документация на АПЛ и есть документация на софт. Первая должна быть написана в строгом соответствии со стандартами, а вторая - так, что бы было понятно и приятно.
Да всё давно придумано до нас. Есть документация на АПЛ и есть документация на софт. Первая должна быть написана в строгом соответствии со стандартами, а вторая - так, что бы было понятно и приятно.
а лучше выпускать срау обе версии - на АПЛ тоже ведь люди работают
Да всё давно придумано до нас. Есть документация на АПЛ и есть документация на софт. Первая должна быть написана в строгом соответствии со стандартами, а вторая - так, что бы было понятно и приятно.
И если вы мне документацию SDK приложите в нефиксированной структуре, я очень странно на вас посмотрю
И вот мы сейчас переоткроем одну очень большую истину, что документация может быть "знаете ли вы", а может быть рабочим инструментом, и во втором случае я буду скучать от любой попытки выйти из рамок