Вниманию всех редакторов, имеющих доступ на запись в SVN. Основателем (BasiL) и мной (Als) :) была разработана определённая система комментирования ревизий, которой желательно следовать. Итак, ничего особенного делать не нужно, просто следовать описанной ниже схеме:
символ название файла с раширением - ваше описание
Мы будем использовать 5 символов:
- + добавление чего-то, целого файла или строчек в файл, однако при добавлении и изменении чего-то в файле необходимо использовать другой символ
- - удаление чего-то, как целого файла, так и строчек из файла, однако при частичном удалении строчек необходимо использовать другой символ
- * изменение чего-то. это тот самый символ, который описывает множественные изменения, т.е. добавления/удаления/изменения в одном файле
- ~ символ обозначающий перенос строк. типичный пример использования - перенос из =UNsorted=.txt :)
- ! последний символ, обозначающий некое критическое изменение, например синтаксическую ошибку всмысле структуры файла, не в смысле русского языка
Описание остаётся свободным для полёта вашей мысли, однако далеко ей улетать не стоит, поэтому есть один параметр, который можно описать в комментарии, это кол-во изменённых строчек. Для нас строка - это понятие, которое включает в себя как оригинал так и переведённый вариант, например:
[Disable drag and drop of items] Отключить перетаскивание элементов
Помечается кол-во просто, если что-то добавилось, то мы пишем +№, где № кол-во строчек, для удаления знак минус (-), для изменения звёздочка (*) и для перемещённых строк соответсвенно тильда (~). Далее, при необходимости, вы можете прокомментировать сделанное вами изменение.
Таким образом идеальный комментаривый выглядит примерно так:
~ =UNsorted=.txt - ~5 в Clist_modern.txt + Clist_modern.txt - +5 из =UNsorted=.txt и +2 после обновления * BossKey.txt - -2 ибо старьё и +3 - актуализация ! Jabber.txt - ашипка %) кривая строка была
Всем спасибо внимание, удачи, ну и конечно огромное спасибо за вклад в развитие языкового пакета :)
