зробити опис api

[GS-0001]

зробити опис api, зокрема:

• дата 9999-12-31
• чому в https://drohobych.rada4you.org/api/mps.json один і той самий депутат зустрічається декілька раз (зміна фракції)
• тощо

[lisoffsky]

@GS-0001 плз поглянь зараз, якщо маєш можливість

[GS-0001]

Норма, але на нашвидкуруч по JSON:

• не зрозуміло, чим id відрізняється від deputy_id
• в блоці mp_infos якось не зрозуміла логіка розміщення та нумерації блоків місячної статистики (але це не до опису, це до api)
• в блоці mp_friends не зрозуміла різниця між id та friend_deputy_id
• в описі політик вказано per_page | False - що це?
• в блоках опису політики зайвий опис count | кількість голосувань на сторінці після result, в api його нема
• фраза Для отримання попередніх голосувань використовуйте посилання: трохи смущає. але якщо розуміти, що голосування розташовуються в порядку спадання дати, то тоді стає зрозуміліше
• в описі api конкретного голосування описка у фразі result | кількість голосувань на сторінці count | результат голосування
• в описі голосувань знову голову зламати над id та division_id
• в блоці vote | результат голосування депутата за дане питання варто розписати варіанти, які приймає значення це поле (через оте aye)
• не описана підструктура whips
• в політиках provisional | чи це сформована політика, чи лише проект політики не зрозуміло за що відповідає false vs true
• в описі конкретної політики пропущено description
• в описі присутнє policy_person_distances, тоді як в api його нема. можливо мова йде про блок people_comparison?
• в support - не описано можливі варіанти, та різницю між support | aye та support | aye_strong

[lisoffsky]

@Sviatoslav-Babilia подивись бдлск. ти знаєш, як це правити

[beastie87]

@Sviatoslav-Babilia зробив правки, я задеплоїв, @GS-0001 @lisoffsky перечитайте будь ласка https://drohobych.rada4you.org/help/data Дякую