Передмова#
Цей документ є оновленням Посібника з якості та стилю Ada 95, що відображає останню версію мови Ada, яку зазвичай називають Ada 2012. Мета цього посібника - допомогти комп'ютерним фахівцям створювати кращі програми на Ada шляхом визначення набору стилістичних рекомендацій, які безпосередньо впливатимуть на якість їхніх програм на Ada. Цей посібник зі стилю не призначено для заміни Довідника з Ади посібником або Обґрунтування, а також він не є навчальним посібником з мови програмування Ada.
Посібник зі стилю поділено на розділи, які відповідають основним рішенням, котрі приймає кожен програміст, створюючи високоякісне, надійне, багаторазове та портативне програмне забезпечення на Ada. Розділи дещо перетинаються, оскільки не всі програмні рішення можуть бути прийняті незалежно. Окремі розділи присвячені представленню вихідного коду, читабельності, структурі програми, практиці програмування, паралелізму, портативності, повторному використанню, продуктивності, а також нова глава присвячена об'єктно-орієнтованим функціям.
Кожна глава розділена на керівні принципи (рекомендації), формат яких є досить гнучким у використанні, оскільки їхній зміст є одночасно і настановчим, і адаптивним. Кожна настанова складається зі стислого викладу принципів, яких слід дотримуватися, та обґрунтування, що пояснює, чому ця настанова є важливою. Настанови також містять приклади використання, а також можливі винятки із застосування настанов. Багато настанов є достатньо конкретними, щоб їх можна було прийняти як корпоративні або проектні стандарти програмування. Інші потребують управлінського рішення щодо конкретного застосування, перш ніж їх можна буде використовувати як стандарти. У таких випадках у прикладах наведено зразок конкретного варіанту, який використовується у всіх настановах.
Передісторія#
Офіс об'єднаної програми Ada (AJPO) профінансував посібник зі стилю Ada 95, який було створено шляхом об'єднання набору настанов з використання Ada 95 з модифікаціями оригінальної настанови з якості та стилю Ada: Настанови для професійних програмістів, версія 02.01.01 (AQ&S 83) (Software Productivity Consortium 1992), розроблених для підтримки Ada 83. Настанови Ada 95 ґрунтуються на великій кількості даних, доступних з проекту Ada 9X, бібліотеки AJPO та спільноти Ada в цілому. Авторами оновлення є технічний персонал Консорціуму продуктивності програмного забезпечення (Software Productivity Consortium), а Агентство перспективних дослідницьких проектів (ARPA) брало участь у роботі над оновленням.
Попередній AQ&S 83 містив набір настанов, які допомагали програмісту дисципліновано використовувати можливості Ади. У 1992 році Консорціум завершив оновлення версії 2.1 посібника зі стилю за контрактом з AJPO. AJPO назвала цей посібник зі стилю "рекомендованим посібником зі стилю для всіх програм Міністерства оборони".
Наразі не існує офіційного оновлення посібника зі стилів для мовної версії Ada 2005 або Ada 2012. Під час тривалого обговорення на конференції SIGAda 2008 посібника зі стилю у зв'язку з оновленням Ади 2005 і його постійною актуальністю, кілька учасників зголосилися викласти посібник у вікіпедію, щоб заохотити спільне оновлення посібника, передавши його в руки фахівців-практиків мови. Частково це стало можливим за умовами безоплатної, всесвітньої, невиключної, безвідкличної ліцензії на необмежене використання матеріалів посібників зі стилю Ada 83 і 95, наданої Об'єднаним програмним офісом DoD з питань Ada, що діє у всьому світі.