Додаток B: Зворотній зв'язок та повідомлення про помилки

• B.1 Загальні директиви
  • B.1.1 Відправлення великих прикріплень
  • B.1.2 Інші місця де можна попросити допомоги
• B.2 Повідомлення про помилки
• B.3 Запит додаткових можливостей
• B.4 Запит можливостей, які вже було запитано
• B.5 Запити підтримки
• B.6 Адміністрування сервера мережі
• B.7 Питання дозволу чогось
• B.8 Створення дзеркала сайту PuTTY
• B.9 Похвали і компліменти
• B.10 Адреса електронної пошти

     Це додаток по забезпеченню зворотного зв'язку з командою розробників PuTTY. Воно передбачено як інтернет-сторінка на сайті PuTTY та як додаток у керівництві PuTTY.

     Розділ B.1 дає загальні директиви по відправленню будь якого виду електронних листів команді розробників. Наступні розділи дають більше специфічних директив по окремим типам електронних листів, таких як повідомлення про помилки та запит характеристик.

B.1 Загальні директиви

     Команда розробників PuTTY отримує величезну кількість пошти. Якщо ви спроможні вирішити ваші проблеми читаючи керівництво, читаючи FAQ, читаючи Інтернет сайт, запитуючи друзів-користувачів, можливо відправляючи повідомлення у групи новин (дивиться розділ B.1.2), чи якимось іншим чином, це зробить наше життя набагато легше.

     Ми отримуємо так багато електронних листів, що ми, буквально, не маємо часу відповісти на всі. Ми жалкуємо про це, але ми нічого не можемо з цим зробити. Отже, якщо ви спроможні уникнути відправлення повідомлення команді PuTTY, ми рекомендуємо вам зробити це. Зокрема, запити підтримки (розділ B.5) можливо ліпше направити у групу новин чи передати локальному експерту, якщо можливо.

     Контактна поштова адреса PuTTY це приватний список розсилки, який містить чотири ци п'ять основних розробників. Хай вас не збиває з пантелику те, що це список розсилки: якщо вам необхідно надіслати конфіденційні дані, як частину повідомлення про помилку, ви можете довіряти людям у списку, які поважають конфіденційність. Також архів публічно не доступний, так що ви не станете жертвою спаму надіслав нам листа.

     Будь-ласка, використовуйте зрозумілу тему в вашому повідомленні. Ми отримуємо величезну кількість пошти і дуже складно знайти повідомлення, яке ми шукаємо, якщо у всіх тема схожа на ‘PuTTY bug’.

B.1.1 Відправлення великих прикріплень

     Так як контактна адреса PuTTY це список розсилки, електронна пошта більше 40Kb буде затримана для інспекції адміністратором розсилки і не пропущена доти, доки він не вирішить, що цей великий розмір вартий того, щоб його пропустили.

     Якщо ви думаєте надсилати якісь великі дані команді PuTTY, це майже завжди погана ідея чи на крайній випадок буде ліпше спочатку запитати в нас чи ми дійсно потребуєм файл. Альтернативно, ви можете помістити файл на інтернет-сайті і просто надіслати нам URL; цим шляхом ми не завантажимо його, якщо не вирішимо, що ми дійсно потребуємо цей файл і лише один з нас завантажить його замість автоматичного копіювання усім розробникам.

     Деякі люди люблять надсилати пошту у форматі MS Word. Будь-ласка не надсилайте нам рапорт про помилку чи будь-яку іншу пошту як документ Word. Документ Word у п'ять разів більше ніж той самий рапорт звичайним текстом. На додаток, багато хто з команди PuTTY читають свою пошту на Unix машинах і їм дуже не зручно копіювати файл на Windows машину для запуску Word. Не лише цьому, але деякі з нас навіть не мають копії Word!

     Деяким людям подобається надсилати нам знімок екрану, який демонструє проблему. Будь-ласка, не робить цього не запитавши спочатку в нас – ми майже ніколи у дійсності не потребуємо інформацію у вигляді знімків екрану. У надсиланні знімку екрану з діалогом помилки майже безсумнівно нема необхідності, коли ви можете просто сказати нам простим текстом, яка помилка відбулася. (У деяких версіях Windows, натискання Ctrl-C, коли відображається діалог помилки, копіює текст повідомлення у буфер обміну). Відправлення повноекранного знімку інколи корисне, але, імовірно, розсудливо перевірити чи потрібен він нам перед його відправленням.

     Якщо ви повинні надіслати знімок екрану, не надсилайте його як .BMP файл. У BMP нема стиснення і він на багато більше ніж інші формати такі як PNG, TIFF та GIF. Конвертуйте файл у правильно стиснений формат зображення перед його відправленням.

     Будь-ласка не відправляйте нам поштою файли, що виконуються. Наш поштовий сервер блокує усю вхідну пошту, яка містить файли, що виконуються, як захист від великої кількості поштових вірусів, які ми отримуєм кожного дня. Якщо ви надсилаєте лист у вигляді файлу, що виконується, воно буде просто викинуто.

     Якщо ви зробили невеличку модифікацію в коді PuTTY, будь-ласка надішліть нам заплату до похідного коду, якщо можливо, це ліпше ніж надсилати величезний .ZIP файл, який містить повні похідні файли плюс вашу модифікацію. Якщо ви лише змінили 10 ліній, ми віддаємо перевагу отримати пошту довжиною 30 ліній, ніж ту, що містить багато мегабайт даних які в нас вже є.

B.1.2 Інші місця, де можна попросити допомоги

     Існують дві групи новин Usenet, які дуже доречні до утиліт PuTTY:

• comp.security.ssh, для питань характерних для використання протоколу SSH;
• comp.terminals, для питань, що стосуються емуляторів терміналу (наприклад, проблем з клавіатурою).

     Якщо ви не можете отримати прямий доступ до Usenet, ви можете отримати доступ до цих груп через Google Groups.

B.2 Повідомлення про помилки

     Якщо, на вашу думку, ви знайшли помилку у PuTTY, першим вашим кроком буде:

• Перевірте сторінку Побажань на сайті PuTTY, та подивиться може ми вже знаємо про проблему. Якщо так, то майже безсумнівно нема необхідності надсилати нам листа про неї, якщо ви не вважаєте, що в вас є додаткова інформація, яка може бути корисною нам при усуненні помилки. (Звісно, якщо нам дійсно потрібна додаткова інформація про подробиці помилки, сторінка Побажань сповістить про це).

• Перевірте Список Змін на сайті PuTTY, і подивиться може ми вже виправили помилку у версії, що розробляється.

• Перевірте FAQ на сайті PuTTY (також постачається як додаток A у посібнику), і подивитись може є відповідь на ваше питання. FAQ це перелік найбільш загальних речей, які люди приймають за помилки, але які помилками не є.

• Завантажте останній зріз, що розробляється і подивиться чи є проблема з ним. Це дійсно варто зробити. Як правило нас не дуже цікавлять помилки, які з'являються у версії, яку ми випустили, але не в тій версії, яку ми розробляємо, тому що звичайно це означає, що ці помилки ми вже виправили. З іншого боку, якщо ви змогли знайти помилку у версії, що розробляється, якої не було в версії, що ми випустили це, імовірно, нова помилка, яку ми ввели після випущеної версії і ми цікавимося цим.

     Якщо жодна з цих можливостей не вирішила вашу проблему і ви все ще потребуєте у тому, щоб повідомити нам про помилку, буде корисним якщо ви включите деяку загальну інформацію:

• Скажіть нам яку версію PuTTY ви використовуєте. Щоб узнати це використовуйте пункт Системного меню «About PuTTY». Будь-ласка не кажіть нам просто «Я використовую останню версію»; електронний лист може бути видаленим, тому що може бути не зрозуміло яка версія була останньою на час відправлення повідомлення.

• PuTTY це додаток для багатьох платформ; скажіть нам у якій версії якої ОС ви запускаєте PuTTY. (Якщо ви запускаєте у Unix чи Windows для Alpha, скажіть нам чи ми зробимо припущення, що ви запускаєте на Windows для Intel так як це основний варіант).

• Скажіть нам за яким протоколом ви з'єднуєтесь: SSH, Telnet, Rlogin чи у режимі Raw.

• Скажіть нам з яким сервером ви з'єднуєтесь; яка ОС і, якщо можливо, який SSH сервер (якщо ви використовуєте SSH). Ви можете отримати деяку інформацію з цього переліку у PuTTY Event Log (дивиться розділ 3.1.3.1 у посібнику).

• Надішліть нам вміст PuTTY Event Log, якщо в вас нема специфічних причин не надсилати (наприклад, якщо він містить конфіденційну інформацію і ви вважаєте, що ми зможемо вирішити вашу проблему без необхідності знати її).

• Спробуйте дати нам так багато інформації, як ви можете, щоб допомогти нам побачити проблему як свою. Якщо можливо дайте нам точну інструкцію крок за кроком для відтворення помилки.

• Не кажіть нам просто, що PuTTY «робить неправильні речі»; скажіть нам повністю і точно, що вона робить і також скажіть нам повністю і точно, що на вашу думку вона повинна робити замість цього. Деякі люди кажуть нам, що PuTTY робить не правильні речі, а виявляється, що вона робить усе вірно, а їх очікування були не вірними. Допоможіть уникнути цієї проблеми, сказавши нам точно, що на вашу думку вона повинна робити і точно, що вона робить.

• Якщо ви можете, вітається ваша спроба виправити проблему самостійно. Заплата до коду, яка виправляє помилку це чудове доповнення до рапорту про помилку. Тим не менш заплата ніколи не замінить гарний звіт про помилку; якщо ваша заплата з помилками чи не підходить і ви не дали нам повну інформацію про помилку, то ми не зможемо знайти ліше рішення.

• http://www.chiark.greenend.org.uk/~sgtatham/bugs.html це стаття про те як взагалі ефективно повідомляти про помилки. Якщо ваш звіт про помилку дуже не зрозумілий, ми можемо попросити вас піти почитати цю статтю і потім надіслати звіт про помилку знову.

     Розумно повідомляти про помилки у документації PuTTY, якщо ви вважаєте, що документація незрозуміла чи безкорисна. Але ми повинні отримати точні подробиці про те, що на вашу думку документація не змогла сказати вам чи як на вашу думку її можна зробити зрозуміліше. Якщо ваша проблема це те, що ви не розумієте документацію ми радимо вам написати у групу новин (дивиться розділ B.1.2) і попросити когось пояснити, що вам не зрозуміло. Потім, якщо ви вважаєте, що документації слід казати вам це, надішліть нам звіт про помилку та поясніть як на вашу думку ми повинні змінити її.

B.3 Запит додаткових можливостей

     Якщо ви бажаєте попросити нові можливості у PuTTY, спершу ви зробите:

• Перевірте сторінку Побажань на інтернет сайті PuTTY і подивитесь чи є вже ваша можливість у списку. Якщо є, то, можливо, ви нічого не досягнете повтором запиту. (Але подивиться розділ B.4, якщо ви бажаєте упевнити нас надати вашій окремій можливості більшого пріоритету).

• Перевірте Список Побажань і Перелік Змін на Інтернет сайті PuTTY і подивиться чи вже не додана ваша можливість у зріз, що розробляється. Якщо так, завантажте останній зріз і дивиться чи є ця можливість. Якщо так, то вона також буде у наступному випуску і нема необхідності писати нам листа.

     Якщо ви не можете знайти вашу характеристику у зрізі, що розробляється чи у Побажаннях, то вам можливо необхідно надіслати запит на цю можливість. Так як автори PuTTY дуже зайняті їм допоможе, якщо ви спробуєте зробити деяку роботу для нас:

• Розробить дизайн настільки глибоко, наскільки спроможні. Подумайте про «вузькі місця». Подумайте, як ваш елемент буде працювати з іншими елементами, що вже існують. Подумайте про інтерфейс користувача. Якщо ви не здатні вигадати простий і інтуїтивний інтерфейс для свого елементу, вас не повинно дивувати те, що ми теж не можемо зробити цього. Завжди намагайтесь враховувати – те, що на вашу думку повинно бути у однині, може опинитись у подвійній (чи більше) кількості чи взагалі може бути відсутне. (Наприклад, якщо ви бажаєте, щоб PuTTY розташовував значок у системному лотку, а не на панелі завдань, вам слід подумати про те, що трапиться у випадку, якщо буде запущено декілька копій PuTTY; як користувач відрізнить одну від іншої?)

• Якщо ви можете програмувати, то можливо варто спробувати написати характеристику самостійно і надіслати нам заплату. Однак, імовірно, буде корисніше, якщо спочатку ви порадитесь з нами; можуть бути проблеми дизайну, про які ви не подумали чи ми можемо зібратись зробити великі зміни у коді, з якими зіткнуться ваші зміни. Якщо ви спочатку зв'яжетесь з розробниками, у вашого коду, який фактично готовий до використання, буде ліпший шанс. Також прочитайте принципи розробки, які описані у додатку D: якщо ви не пристосуєтесь до них, ми, імовірно, не зможемо прийняти вашу заплату.

B.4 Запит можливостей, які вже запитано

     Якщо характеристика вже вказана в Побажаннях, то звичайно це значить, що ми колись додамо її у PuTTY. Тим не менш це може бути не у найближчому майбутньому. Якщо є у Побажаннях характеристика, яку ви бажаєте побачити у найближчому майбутньому, є декілька речей, які ви можете спробувати, щоб збільшити рівень її пріоритету:

• Напишіть нам листа і голосуйте за неї. (Перевірте чи згадали ви, що бачили її у Списку Побажань, інакше ми можемо подумати, що ви його навіть не читали). Імовірно це буде мати дуже великий ефект; якщо багато людей голосують за щось, це може мати значення, але один чи два голоси за окрему характеристику навряд негайно змінять наш список пріоритетів. Пропозиція нового та невідхильного підтвердження може допомогти. Також не очікуйте відповіді.

• Запропонуйте нам грошей, щоб ми зробили цю роботу як можна швидше. Іноді це працює, але не завжди. Команда PuTTY має роботу на повну зайнятість і ми працюємо над PuTTY в наш вільний час; іноді ми можемо витратити більше нашого вільного часу у обмін на деякі гроші, але якщо ви бажаєте підкупити нас для великої характеристики імовірно, що в нас не вистачить вільного часу – заплатите ви нам чи ні. (Також ми не приймаємо хабар, щоб додавати погані характеристики у Побажання, тому що перш за все ми бажаємо надавати користувачам високоякісне програмне забезпечення).

• Запропонуйте нам допомогу у написанні коду. Імовірно це єдиний шлях швидко отримати характеристику, якщо це велика характеристика в нас нема часу зробити її самотужки.

B.5 Запити підтримки

     Якщо ви намагаєтесь примусити PuTTY зробити щось для вас і це не працює, але ви не впевнені помилка це чи ні, то будь-ласка пошукайте допомогу десь ще. Це найбільш загальний тип пошти, яку отримує команда PuTTY і ми просто не маємо часу, щоб відповісти на всі запитання. Питання цього типу включають:

• Якщо ви бажаєте зробити щось з PuTTY і в вас нема ідей з чого почати і читання посібника не допомогло, спробуйте написати в групу новин (дивиться розділ B.1.2) і порадьтесь, може хтось дасть вам пояснення.

• Якщо ви намагаєтесь зробити щось з PuTTY, але це не працює і ви не впевнені це помилка PuTTY чи помилка у вашому SSH сервері чи просто ви щось робите невірно, тоді спробуйте написати у групу новин (дивиться розділ B.1.2) і порадьтесь, може хтось може вирішити вашу проблему. Чи спробуйте зробить теж саме з іншим SSH клієнтом і подивиться чи зможе він так працювати. Будь-ласка, не повідомляйте про це як про помилку PuTTY, доки ви дійсно не впевнитесь – це помилка у PuTTY.

• Якщо хтось інший встановив вам PuTTY чи ви використовуєте PuTTY на чужій машині, спробуйте спочатку запитати в нього. Найбільш імовірно, що вони розуміють як вони встановили і як, за їх очікуваннями, ви повинні використовувати PuTTY, а не ми.

• Якщо ви вдало зробити з'єднання з вашим сервером і тепер бажаєте дізнатись, що набирати у командному рядку серверу чи інші деталі як використовувати програмне забезпечення серверу, запитайте у вашого системного адміністратора. Це не проблема команди PuTTY. PuTTY це комунікаційна утиліта, як телефон; якщо ви не можете розмовляти тією мовою, що й людина у телефону на іншому кінці, це не робота телефонної компанії вчити вас йому.

     Якщо ви абсолютно не можете отримати відповідь на своє запитання будь-яким інші шляхом, ви можете спробувати написати нам листа, але ми не можемо гарантувати, що буде час відповісти на нього.

B.6 Адміністрування серверу мережи

     Якщо сайт PuTTY «упав» (Connection Timed Out), будь-ласка не турбуйтесь, не пишіть нам, щоб сказати про це. Багато хто з нас читає свою пошту на тій самій машині, де знаходиться наш сайт, тому якщо ця машина «впаде», то ми отримаємо повідомлення перед тим як прочитаємо нашу пошту. Тому нема сенсу казати нам, що наш сервер «упав».

     Звичайно, якщо сайт видає іншу помилку (Connection Refused, 404 Not Found, 403 Forbidden чи ще щось), то ми не отримаємо повідомлення і варто сказати нам про неї.

     Якщо ви бажаєте повідомити про проблему з нашим сайтом перевірте, що ви дійсно дивитесь на наш справжній сайт, а не на дзеркало. Справжній сайт знаходиться за адресою http://www.chiark.greenend.org.uk/~sgtatham/putty/; якщо ви читаєте не його, то не повідомляйте нам про проблему, до тих пір, доки ви не перевірите, що це дійсно проблема з головним сайтом. Якщо це лише проблема з дзеркалом, спочатку спробуйте зв'язатись з адміністратором сайту-дзеркала, а з нами зв'язуйтесь лише якщо це вирішить проблему (у випадку, якщо нам необхідно видалити дзеркало з нашого списку).

B.7 Питання дозволу чогось

     PuTTY розповсюджується під MIT Ліцензією (дивиться додаток С за деталями). Це означає, що ви можете робити майже усе, що вам заманеться з нашим програмним забезпеченням, нашим вихідним кодом і нашою документацією. Єдина річ, яку вам не дозволено це видаляти наше сповіщення про авторські права чи сам текст ліцензії чи затримувати нас відповідачем по закону, якщо щось трапилось не так.

     Отже, якщо ви бажаєте дозволу, щоб включити PuTTY у диск до журналу чи як частину колекції корисного програмного забезпечення на CD чи Інтернет сайті, то дозвіл вже дано. У вас нема необхідності писати нам листа і запитувати. Просто робить це. Нас це не турбує.

(Якщо ви бажаєте розповсюджувати PuTTY разом з вашою власною програмою для використання з нею, чи якщо ви бажаєте розповсюджувати PuTTY в межах вашої організації, то ми рекомендуємо вам надавати вашу власну першочергову технічну підтримку, щоб відповідати на питання про взаємодію PuTTY з вашим оточенням. Якщо ваші користувачі будуть писати безпосередньо нам, ми не зможемо відповісти їх щось корисне про ваше специфічне встановлення).

     Якщо ви бажаєте використовувати частину вихідного коду PuTTY у інший програмі, то варто нам написати, з'ясувати технічні деталі, але якщо все, що ви бажаєте це попросити дозволу, то вам не варто турбуватись. Ви вже маєте дозвіл.

B.8 Створення дзеркалу сайту PuTTY

     Дзеркала сайту PuTTY вітаються, особливо у регіонах, які погано покрити дзеркалами, що вже існують. Будь-ласка не набридайте нам просячи дозволу перед встановленням дзеркалу. В вас вже є дозвіл. Ми завжди раді мати більше дзеркал.

     Якщо ви напишете нам після встановлення дзеркала і перевірки його роботи і скажете нам у якій країні воно знаходиться, тоді ми додамо його на сторінку Дзеркал на сайті PuTTY.

     Якщо в вас є технічні запитання о процесі створення дзеркала, тоді ви можете побажати написати нам перед встановленням дзеркала (дивиться також директиви на сторінці Дзеркал); але якщо ви просто бажаєте попросити дозволу, ви не потребуєте у ньому. В вас вже є дозвіл.

B.9 Похвали і компліменти

     Одна з основних нагород, які підтримують вільне програмне забезпечення це отримання електронної пошти, яка просто каже «дякую». Ми завжди раді отримувати електронну пошту такого типу.

     Нажаль в нас нема часу відповідати усім персонально. Якщо ви надіслали нам електронного листа з компліментом і не отримали відповідь, будь-ласка не думайте, що ми проігнорували вас. Ми отримали його і ми раді йому; в нас просто нема часу відповісти вам персонально.

     Кожному, хто колись надішле нам похвалу чи комплімент у минулому чи майбутньому: you're welcome!

B.10 Адреса електронної пошти

     Поточна адреса електронної пошти це <putty@projects.tartarus.org>.