История изменений
Исправление crutch_master, (текущая версия) :
P.S. description у тебя таки по-русски :-)
Так я и ничего против не имею, что бы он был по-русски, это же данные. хотя в идеале там должен быть какой-нибудь gettext.
А как можно будет внести изменения в мд, если его не искать?
Его руками не надо искать он или по названию функции типа в подкаталоге или еще как-нибудь.
И как скрипт узнает, что документация стала правильной
Никак, но хотя бы он формально пнёт кодера, чтобы тот что-нибудь накалякал. Сейчас тоже самое делают, только парсят комментарии. В javadoc, например, куча всякого markup'а и всё это занимает больше, чем код. А потом также парсится, собирается куда-то, проверяется, чтобы названий аргументов было столько же и т.д. Типа в рантайме это не нужно, хотя бывает нужно и в идеале там какая-то ленивая подгрузка должна быть.
Исправление crutch_master, :
P.S. description у тебя таки по-русски :-)
Так я и ничего против не имею, что бы он был по-русски, это же данные. хотя в идеале там должен быть какой-нибудь gettext.
А как можно будет внести изменения в мд, если его не искать?
Его руками не надо искать он или по названию функции типа в подкаталоге или еще как-нибудь.
И как скрипт узнает, что документация стала правильной
Никак, но хотя бы он формально пнёт кодера, чтобы тот что-нибудь накалякал. Сейчас тоже самое делают, только парсят комментарии. В javadoc, например, куча всякого markup'а и всё это занимает больше, чем код (причём половина того, что там есть - не нужно и можно достать через рефлексию). А потом также парсится, собирается куда-то, проверяется, чтобы названий аргументов было столько же и т.д. Типа в рантайме это не нужно, хотя бывает нужно и в идеале там какая-то ленивая подгрузка должна быть.
Исходная версия crutch_master, :
P.S. description у тебя таки по-русски :-)
Так я и ничего против не имею, что бы он был по-русски, это же данные. хотя в идеале там должен быть какой-нибудь gettext.
А как можно будет внести изменения в мд, если его не искать?
Его руками не надо искать он или по названию функции типа в подкаталоге или еще как-нибудь.
И как скрипт узнает, что документация стала правильной
Никак, но хотя бы он формально пнёт кодера, чтобы тот что-нибудь накалякал. Сейчас тоже самое делают, только парсят комментарии. В javadoc, например, куча всякого markup'а и всё это занимает больше, чем код. А потом также парсится, собирается куда-то, проверяется, чтобы названий аргументов было столько же и т.д. Типа в рантайме это не нужно, хотя бывает нужно и в идеале там какая-то ленивая подгрузка должна быть.