Бывает
Я вот не понимаю настойчивых вопросов типа "так чо там" - как будто кто-то должен

Никто ничего никому не должен)
Неужели я так плохо попросил совет?

То время, что ты и я потратили на бессмысленную переписку, мог написать пару слов о ридми)

Как развернуть проект локально, пару строчек про бизнес проект, авторов с контактами, стек с ссылками на скачивание для развертки, хинты для разработки (команды make, например). Что первое в голову пришло

Btw: database, not date

Кратно и по существу, спасибо 👍

По-хорошему, описать шаги так, чтобы развернуть проект мог даже не программист ( к примеру, аналитик)

Ребят, всем привет. Делаю простенкий TCP Relay. Делаю accept на Server socket, получаю обычный, потом создаю еще один обычный сокет и подключаюсь к http серверу. Потом просто копирую из inputstream одного сокета в outputstream другого и наоборот. Причем код копирования каждый рас запускается в отдельном Runnable на Executor-e. Но если на сокеты не сетать timeout, то через несколько запросов (как понимаю просто треды заканчиваются в executor-е) очередной начинает висеть. Дебажнул и такое впечатление, что блокируется на чтении из http сервера обратно на клиент. Тоесть http server -> tcp relay -> client.
Никак не хочется подниматься на уровень http, так как хочу сделать tcp relay универсальным (то есть не важно будет какой протокол будет работать наверху tcp).  Или сейчас так не делают или по каким-то причинам, мне неизвестным, это невозможно? Заранее большое спасибо за ответ.

А ещё расписать домен, какие сущности, что обозначают, как их использовать, тесты, на которые почмотреть. Чтобы человек который мог посмотреть на него, понял что это, для чего и верхнеуровневую структуру до такой степени, чтобы уже детали то в коде понять

Я так понимаю, это расписывается в том случае, если нет ТЗ?

Звучит неплохо, но у нас сущности задокументированы в самом пакете сущностей. Но лишним думаю точно не будет

Ну я скорей про open source имел ввиду

Документация это подробная документация, а в ридми можно например указать, что вот это главные сущности и работа с ними например вот так обычно ведётся(так часто в либах делают) Посмотрите разные readme на github проектов популярных

Самое главное - определиться, для кого и зачем это вообще писать.

какой самый просто способ разархивировать .RAR файл через java код?

Пример из жизни: я пишу readme для воображаемого инженера, который никогда не видел этот код, но ему поставили задачу исправить баг.

В моем случае, это пишется для человека, который будет смотреть мой проект по ТЗ, которое данная компания мне прислала

Поэтому мои readme обычно кратко отвечают на вопросы
1) как собрать проект, какие дополнительные настройки необходимы
2) как запустить под дебаггером
3) примеры запросов / как протестироват.
4) всё остальное, что может потребоваться знать, чтобы разобраться в коде (например, неочевидные зависимости в коде, и т.д.)

И я думаю, слишком описывать его не нужно
Но то, что люди писали выше о ридми( если это open source, какие шаги должны быть и т.д ), было интересно узнать

Ты пробовал гулгить?
Первые же 2 библиотеки junrar https://github.com/edmund-wagner/junrar

Или java-unrar
https://gitlab.com/axet/java-unrar