snark писал(а):
Просто подумайте, как новый пользователь, т.е. как то так:
Цитата:
Последняя версия - 6.0, значит если заморачиваться с этим биллингом, то есть смысл ставить ее ...
<спустя некоторое время ушедшее на чтение мануала>
Интересно, а как тут обновления происходят? Стоп! Почему инструкция к новой версии ссылается на старую версию?..
Мы, те кто давно с вами, знаем, что 6.0 это "почти" 5.2, но новый пользователь этого же не знает и для него отсылка из доки топовой версии в доку со старой будет не совсем понятна.
Хорошо, следуя вашей логике получится следующее. Пусть у нас версия 4.6 , обновляемся с 4.5. Пусть описываем только специфические шаги, со ссылками на соотвествующую документацию.
1. Вышла версия 4.6.
Цитата:
2. Вышла версия 5.0
Цитата:
######## Обновление производится с версии 4.6 и младше #####################
1) Делаем первый шаг по ссылке
http://bgbilling.ru/v4.6/docs.shtml (тут меняем ссылку 4.6 на 5.0)
2) Делаем второй шаг по ссылке
http://bgbilling.ru/v4.6/docs.shtml(тут меняем ссылку 4.6 на 5.0)
3) Делаем третий шаг по ссылке
http://bgbilling.ru/v4.6/docs.shtml(тут меняем ссылку 4.6 на 5.0)
#################################################
1. Делаем четвертый шаг по ссылке
http://bgbilling.ru/v5.0/docs.shtml2. Делаем пятый шаг по ссылке
http://bgbilling.ru/v5.0/docs.shtml3. Делаем шестой шаг по ссылке
http://bgbilling.ru/v5.0/docs.shtml2. Вышла версия 5.1
Цитата:
######## Обновление производится с версии 4.6 и младше #####################
1) Делаем первый шаг по ссылке
http://bgbilling.ru/v4.6/docs.shtml (тут меняем ссылку на 5.1)
2) Делаем второй шаг по ссылке
http://bgbilling.ru/v4.6/docs.shtml(тут меняем ссылку на 5.1)
3) Делаем третий шаг по ссылке
http://bgbilling.ru/v4.6/docs.shtml(тут меняем ссылку на 5.1)
#################################################
######## Обновление производится с версии 5.0 и младше #####################
1) Делаем четвертый шаг по ссылке
http://bgbilling.ru/v5.0/docs.shtml (тут меняем ссылку на 5.1)
2) Делаем пятый шаг по ссылке
http://bgbilling.ru/v5.0/docs.shtml (тут меняем ссылку на 5.1)
3) Делаем шестой шаг по ссылке
http://bgbilling.ru/v5.0/docs.shtml (тут меняем ссылку на 5.1)
#################################################
1. Делаем седьмой шаг по ссылке
http://bgbilling.ru/v5.1/docs.shtml 2. Делаем восьмой шаг по ссылке
http://bgbilling.ru/v5.1/docs.shtml 3. Делаем девятый шаг по ссылке
http://bgbilling.ru/v5.1/docs.shtml 2. Вышла версия 5.2
Цитата:
######## Обновление производится с версии 4.6 и младше #####################
1) Делаем первый шаг по ссылке
http://bgbilling.ru/v4.6/docs.shtml (тут меняем ссылку на 5.2)
2) Делаем второй шаг по ссылке
http://bgbilling.ru/v4.6/docs.shtml(тут меняем ссылку на 5.2)
3) Делаем третий шаг по ссылке
http://bgbilling.ru/v4.6/docs.shtml(тут меняем ссылку на 5.2)
#################################################
######## Обновление производится с версии 5.0 и младше #####################
1) Делаем четвертый шаг по ссылке
http://bgbilling.ru/v5.0/docs.shtml (тут меняем ссылку на 5.2)
2) Делаем пятый шаг по ссылке
http://bgbilling.ru/v5.0/docs.shtml (тут меняем ссылку на 5.2)
3) Делаем шестой шаг по ссылке
http://bgbilling.ru/v5.0/docs.shtml (тут меняем ссылку на 5.2)
#################################################
######## Обновление производится с версии 5.1 и младше #####################
1) Делаем седьмой шаг по ссылке
http://bgbilling.ru/v5.1/docs.shtml (тут меняем ссылку на 5.2)
2) Делаем восьмой шаг по ссылке
http://bgbilling.ru/v5.1/docs.shtml (тут меняем ссылку на 5.2)
3) Делаем девятый шаг по ссылке
http://bgbilling.ru/v5.1/docs.shtml (тут меняем ссылку на 5.2)
##################################################################
1. Делаем десятый шаг по ссылке
http://bgbilling.ru/v5.2/docs.shtml 2. Делаем одиннадцатый шаг по ссылке
http://bgbilling.ru/v5.2/docs.shtml 3. Делаем двенадцатый шаг по ссылке
http://bgbilling.ru/v5.2/docs.shtml И так далее.
1. Аргумент 1. После выхода 20-ой версии, нужно в 20-ти местах поправить все ссылки . Т.е сейчас в 6.0 есть если в секции "Обновление производится с версии 3.5 и младше есть какая-то ссылка, то нужно обязательно ее поправить на документацию 6.0 версии.
2. Аргумент 2. Пусть будет чуть-чуть вымышленный пример , чтобы показать . Допустим в 5.2 добавили статусы настраиваемые и при переходе с 5.1 на 5.2 нужно их настроить . Ссылки на соответствующие настройки в документации 5.2. А в 6.0 мы вдруг решим вообще упразднить понятие статуса и глобальным конвертером превратим его в в какой-то например "Состояние", которое настраивается по другому, называется по другому и т.п. Главы про статусы больше нет , ссылаться не на что. Но мы напишем конверте который существующий статусы в 5.2 превращает в "Состояния". Но если пользователь обновляется с 5.1 ему нужно вначале настроить статус по документации 5.2 , а потом конвертер превратии их в Состояния, которые описаны в 6.0. Я к тому что в новой документации вообще главы интересующей может не быть в общем случае , так как там все переделали .
И вообще повторюсь - это проблемы тех, кто перескакивает через версию , их меньшинство и они должны быть готовы к трудностям. Чем больше версий они перескакивают, чем больше трудностей.