Як написати Readme
Файл Readme - це невеликий за обсягом документ, який зазвичай додається до програми. Файли Readme пишуться розробниками програмного забезпечення і містять базову інформацію про програму, включаючи дані про установку або керівництво про системні настройках, контактну інформацію, ліцензію, подяки та інформацію про версію ПЗ. Для розповсюдження програмного забезпечення важливо знати, як слід писати файл Readme. Погано написаний документ Readme може розчарувати, втомити користувача, в той час як вдалий варіант допоможе йому з легкістю дізнатися базову інформацію про вашу програму.
Кроки
1
Увімкніть контактну інформацію. Це, ймовірно, найважливіша частина документа Readme. Контактна інформація дозволить користувачеві зв`язатися з вами, щоб запропонувати вам доповнити програму, поставити запитання, виправити помилку або оплатити програму. Увімкніть назву компанії, вебсайт, Email і телефонний номер (ця інформація займе пару рядків).- Приклад наведено на картинці.
2
Вставте дату в ваш Readme. Це невеликий, але дуже важливий крок. Важливо позначити дату поширення вашої програми. Так користувачі будуть в курсі оновлень версії програми, а також зможуть визначити, чи підтримується вона до цих пір.
3
Запишіть назву програми, версію та інформацію про ціну. Нагорі напишіть назву програми та номер версії. Нижче напишіть ціну за повну версію. Якщо ви поширюєте програму за допомогою фізичних носіїв, таких як CD, можете не включати інформацію про ціну, тому що користувачі, ймовірно, вже і так заплатили за програму.
4
Коротко опишіть програму. В одному-двох реченнях дайте короткий опис вашої програми. Наприклад: "Цей додаток відстежує настрій користувача, аналізуючи його активність в інтернеті, після чого змінює простір на робочому столі таким чином, щоб підлаштуватися під емоційний стан користувача."- Якщо у вашого програмного забезпечення досить широкий список функцій, можете розширити опис на цілий абзац або два. Можете використовувати маркований список, щоб пронумерувати всі функції і можливості програми.
5
Опишіть мінімальні вимоги для програми. У хорошому файлі Readme повинна бути інформація, що стосується мінімальних вимог для програми та інструкції по установці. Якщо для установки програми потрібна ще одна частина програмного забезпечення, не забудьте згадати про це. Ви також можете включити інформацію про рекомендованих вимогах (наприклад, завантаження CPU).
6
Включіть інформацію про ліцензії та авторські права. Наприкінці не забудьте вписати інформацію про дату встановлення авторського права і ліцензування програми.
Поради
- Щоб користувачам не треба було форматувати ваш файл, збережіть його в простому текстовому форматі (.txt).
- У назва файлу Readme включіть назву програми- таким чином, користувач буде шукати файл Readme за назвою програми.
Що вам знадобиться
- Комп`ютер
- Текстовий редактор
