sadmadrus / chessBox

chessBox
Apache License 2.0
0 stars 0 forks source link

Описание сервиса игры (шахматной партии) #48

Closed nekr0z closed 1 year ago

nekr0z commented 1 year ago

Начинаю работать над #45.

Что я забыл, что не учёл, где перемудрил?

nekr0z commented 1 year ago

я без полезных комментариев, только с вопросами

Не скромничай, ты нашла пару важных багов и недоделок!

nekr0z commented 1 year ago

Может имеет смысл перенести описания со строк 11-24 внутрь соответствующих разделов для API сразу после соответствующего заголовка? Туда-сюда скроллить не очень удобно. К слову, "сдача" вначале файла не описана, пропущена, а в API есть

Я старался текстовые описания делать для тех случаев, которые не очень понятны, а в разделе API оставлять только ту информацию, которая будет релевантна при написании сервисов, которые будут с этим API взаимодейстовать. Сдачу счёл слишком простой, чтобы описывать.

Наверно, надо будет сделать детальные описания логики работы сервиса, но я думал делать это в процессе разработки, потому что не надеюсь учесть всё сразу.