--- aliases: tags: - maturity/🌱 date: 2024-11-03 --- ![[../../../meta/files/Pasted image 20241103220651.png]] - **Code Style (Π‘Ρ‚ΠΈΠ»ΡŒ ΠΊΠΎΠ΄Π°)**: - ΠŸΡ€ΠΈΠΌΠ΅Π½Π΅Π½ Π»ΠΈ ΡΡ‚ΠΈΠ»ΡŒ форматирования ΠΏΡ€ΠΎΠ΅ΠΊΡ‚Π°? - Достаточно Π»ΠΈ [[Π§ΠΈΡ‚Π°Π΅ΠΌΡ‹ΠΉ ΠΊΠΎΠ΄|Ρ‡ΠΈΡ‚Π°Π΅ΠΌ ΠΊΠΎΠ΄]] (Π΄Π»ΠΈΠ½Π° ΠΌΠ΅Ρ‚ΠΎΠ΄ΠΎΠ² ΠΈ Ρ‚.ΠΏ.)? - Π‘ΠΎΠ±Π»ΡŽΠ΄Π°Π΅Ρ‚ΡΡ Π»ΠΈ ΠΏΡ€ΠΈΠ½Ρ†ΠΈΠΏ DRY (Don't Repeat Yourself)? - БоотвСтствуСт Π»ΠΈ ΠΈΠΌΠ΅Π½ΠΎΠ²Π°Π½ΠΈΠ΅ общСпринятым соглашСниям? - **Tests (ВСсты)**: - ΠŸΡ€ΠΎΡ…ΠΎΠ΄ΡΡ‚ Π»ΠΈ всС тСсты? - НовыС Ρ„ΡƒΠ½ΠΊΡ†ΠΈΠΈ протСстированы? - ΠŸΠΎΠΊΡ€Ρ‹Ρ‚Ρ‹ Π»ΠΈ ΠΊΡ€Π°ΠΉΠ½ΠΈΠ΅ случаи? - Π˜ΡΠΏΠΎΠ»ΡŒΠ·ΡƒΡŽΡ‚ΡΡ Π»ΠΈ ΡŽΠ½ΠΈΡ‚-тСсты ΠΈ ΠΈΠ½Ρ‚Π΅Π³Ρ€Π°Ρ†ΠΈΠΎΠ½Π½Ρ‹Π΅ тСсты? - Π•ΡΡ‚ΡŒ Π»ΠΈ тСсты для Π½Π΅Ρ„ΡƒΠ½ΠΊΡ†ΠΈΠΎΠ½Π°Π»ΡŒΠ½Ρ‹Ρ… Ρ‚Ρ€Π΅Π±ΠΎΠ²Π°Π½ΠΈΠΉ, Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€, ΠΏΡ€ΠΎΠΈΠ·Π²ΠΎΠ΄ΠΈΡ‚Π΅Π»ΡŒΠ½ΠΎΡΡ‚ΡŒ? - **Documentation (ДокумСнтация)**: - Π•ΡΡ‚ΡŒ Π»ΠΈ докумСнтация для Π½ΠΎΠ²Ρ‹Ρ… Ρ„ΡƒΠ½ΠΊΡ†ΠΈΠΉ? - ΠŸΠΎΠΊΡ€Ρ‹Ρ‚Ρ‹ Π»ΠΈ Ρ€Π°Π·Π»ΠΈΡ‡Π½Ρ‹Π΅ Π²ΠΈΠ΄Ρ‹ Π΄ΠΎΠΊΡƒΠΌΠ΅Π½Ρ‚Π°Ρ†ΠΈΠΈ: README, API, user guide ΠΈ Π΄Ρ€.? - ΠŸΠΎΠ½ΡΡ‚Π½Ρ‹ Π»ΠΈ Π΄ΠΎΠΊΡƒΠΌΠ΅Π½Ρ‚Ρ‹, Π½Π΅Ρ‚ Π»ΠΈ ошибок Π² Ρ‚ΠΈΠΏΠΎΠ³Ρ€Π°Ρ„ΠΈΠΊΠ΅ ΠΈ Π³Ρ€Π°ΠΌΠΌΠ°Ρ‚ΠΈΠΊΠ΅? - **Implementation Semantics (Π‘Π΅ΠΌΠ°Π½Ρ‚ΠΈΠΊΠ° Ρ€Π΅Π°Π»ΠΈΠ·Π°Ρ†ΠΈΠΈ)**: - БоотвСтствуСт Π»ΠΈ рСализация исходным трСбованиям? - ΠšΠΎΡ€Ρ€Π΅ΠΊΡ‚Π½Π° Π»ΠΈ Π»ΠΎΠ³ΠΈΠΊΠ°? - НСт Π»ΠΈ излишнСй слоТности? - НадСТна Π»ΠΈ рСализация (вопросы конкурСнтности, ΠΎΠ±Ρ€Π°Π±ΠΎΡ‚ΠΊΠΈ ошибок ΠΈ Ρ‚.Π΄.)? - Π₯ΠΎΡ€ΠΎΡˆΠ°Ρ Π»ΠΈ ΠΏΡ€ΠΎΠΈΠ·Π²ΠΎΠ΄ΠΈΡ‚Π΅Π»ΡŒΠ½ΠΎΡΡ‚ΡŒ? - БСзопасна Π»ΠΈ (Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€, отсутствиС SQL-ΠΈΠ½ΡŠΠ΅ΠΊΡ†ΠΈΠΉ)? - МоТно Π»ΠΈ Π½Π°Π±Π»ΡŽΠ΄Π°Ρ‚ΡŒ Π·Π° Ρ€Π΅Π°Π»ΠΈΠ·Π°Ρ†ΠΈΠ΅ΠΉ (ΠΌΠ΅Ρ‚Ρ€ΠΈΠΊΠΈ, Π»ΠΎΠ³ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅ ΠΈ Ρ‚.Π΄.)? - Вянут Π»ΠΈ Π½ΠΎΠ²Ρ‹Π΅ зависимости свой вСс, ΠΏΡ€ΠΈΠ΅ΠΌΠ»Π΅ΠΌΠ° Π»ΠΈ ΠΈΡ… лицСнзия? - **API Semantics (Π‘Π΅ΠΌΠ°Π½Ρ‚ΠΈΠΊΠ° API)**: - Насколько ΠΊΠΎΠΌΠΏΠ°ΠΊΡ‚Π½ΠΎ API, ΠΎΠ½ΠΎ достаточно большоС ΠΈΠ»ΠΈ Π½Π°ΠΎΠ±ΠΎΡ€ΠΎΡ‚? - Π•ΡΡ‚ΡŒ Π»ΠΈ ΠΎΠ΄ΠΈΠ½ способ достиТСния Ρ†Π΅Π»ΠΈ, Π±Π΅Π· мноТСствСнных ΠΏΠΎΠ΄Ρ…ΠΎΠ΄ΠΎΠ²? - API прСдсказуСмо, слСдуСт Π»ΠΈ ΠΎΠ½ΠΎ ΠΏΡ€ΠΈΠ½Ρ†ΠΈΠΏΡƒ наимСньшСго удивлСния? - Π―Π²Π»ΡΡŽΡ‚ΡΡ Π»ΠΈ внутрСнности API скрытыми ΠΎΡ‚ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ? - НСт Π»ΠΈ ΠΈΠ·ΠΌΠ΅Π½Π΅Π½ΠΈΠΉ, Π»ΠΎΠΌΠ°ΡŽΡ‰ΠΈΡ… ΠΎΠ±Ρ€Π°Ρ‚Π½ΡƒΡŽ ΡΠΎΠ²ΠΌΠ΅ΡΡ‚ΠΈΠΌΠΎΡΡ‚ΡŒ? - Насколько ΠΏΠΎΠ»Π΅Π·Π½ΠΎ ΠΈ Π½Π΅ слишком спСцифично API? *** ## ΠœΠ΅Ρ‚Π° информация **ΠžΠ±Π»Π°ΡΡ‚ΡŒ**:: [[../meta/zero/00 Π Π°Π·Ρ€Π°Π±ΠΎΡ‚ΠΊΠ°|00 Π Π°Π·Ρ€Π°Π±ΠΎΡ‚ΠΊΠ°]] **Π ΠΎΠ΄ΠΈΡ‚Π΅Π»ΡŒ**:: **Π˜ΡΡ‚ΠΎΡ‡Π½ΠΈΠΊ**:: **Π‘ΠΎΠ·Π΄Π°Π½Π°**:: [[2024-11-03]] **Автор**:: ### Π”ΠΎΠΏΠΎΠ»Π½ΠΈΡ‚Π΅Π»ΡŒΠ½Ρ‹Π΅ ΠΌΠ°Ρ‚Π΅Ρ€ΠΈΠ°Π»Ρ‹ - ### Π”ΠΎΡ‡Π΅Ρ€Π½ΠΈΠ΅ Π·Π°ΠΌΠ΅Ρ‚ΠΊΠΈ