Не так давно я вернулся к разработке zifi. Этот код был позаброшен больше 9 месяцев назад, и тогда я… устал продолжать :)
Но — не забываю, есть старые проблемы, есть вновь найденные неудобства. Надо фиксить, надо развивать.
Оболочка полезная вышла.
Но, ччёрт, столько времени прошло…
Как понять свой старый код через год? И как писать так, что-бы его можно было пОнять позже?

Я выложу свои идеи по этому поводу, но хотелось бы услышать Ваши стандарты разработки.

Итак, мои личные рекомендации:

1. Не пишите код в линию.
ld a,h, b,l,d,i: or a: jr z,milf — это замечательно, и настолько лаконично… но двояко, для меня лично.
Это крайне слабо читаемо. Да, я понимаю — «сгущение» (не подберу другого слова) смысла в строках.
Но читаемость кода, на мой взгляд — падает основательно. Из-за приёмов, подобных «ld a,h, b,l,d,i».
Возможно, этот метод только лично мне не привычен, ок.
Но код в строчку — читать не могу.

2. Разделяйте процедуры переносами строк.
когда вы видите сплошную ленту дизасемблера — это одно. тут уж увы, не поформатишь, пожинай логику байтами.
но в СВОЁМ коде — отделяйте блоки и процедуры друг от друга.
визуальное восприятие блоками — резко повышает читаемость и восприятие логики каждой части программы.
мало пары переносов — да пожалуйста, используй свои разделители в комментариях.
важнее всего здесь — визуальное разделение блоков кода.
Тебе его потом отлаживать.

3. Применяйте понятные метки.
Время 8-ми байтовых меток давно ушло. Экономить не обязательно, не ZEUS.
Для важных процедур стоит использовать метки, максимально описывающие — что делает процедура.
Важно выделять важные места в программе, стараясь максимально понятно их называя:

change_page   ld bc,#7ffd
...

Но! для незначащих переходов — стоит использовать короткие метки перехода sjasm — 1b, 1f:

2 ld de,0
jr 1f
jr 2b
...
1 ld hl,0

на всякий: 1 — это номер метки, b / f — это сторона перехода — back или forward: назад к метке 1, или вперёд по коду к ней.

Естественно, злоупотреблять ними не стоит; но я нахожу им отличное применение — вместо ненужных «названиефункции1» или «названиефункции3».

3.1. equ для меток
Об этом нельзя сказать ничего плохого, но есть метод проще. Вместо чего-то типа:

ololo 
 equ $+1
ld hl,0

заюзайте вариант попроще:

ld (ololo+1),hl

3.2. Ох, я намешал этих 2b / 1f, теряюсь!
Сделай себе понятнее. Определи понятные метки вместо временных для тех, которые ВАЖНЫ.
ибо временные метки важными не являются по определению. и хер ты на нужную сможешь сослаться.

4. Протестил — оформь процедурой.
Всё обычно начинается с наброска, с теста — заработает ли, выйдет ли что-нибудь из этой затеи?
но если уж всё получается — выдели этот блок, с умным и понятным именем в отдельную процедуру.
что это даст?

упрощение отладки:

start
		ld sp,#bfff
		call all_init
 		call set_256c_mode		
		call sd_init

по сути — три щелчка по f8, и ты из прошёл.
и если есть проблема — тут же ясно в какой именно процедуре зараза :)
и да, давай процедуру с процедурами, окей?

5. Да всё понятно это, банальные вещи тулишь. Что делать с упрощением доступа к данным из асма, типа где IX+56 и т.д.?
Замечательная проблема, приводящая к постоянной автозамене.
Господа, юзайте структуры.
вкратце:
ld а,(ix+sprite.size_x) — здесь мы получаем доступ к необходимой ячейке по её имени с приставкой, к чему именно она принадлежит.
описание её выглядит вот так (справедливо для sjasmplus):

struct sprite
y		byte
size_y		byte
x		byte
size_x		byte
tnum		byte
spal		byte	
	ends

для себя отмечаем, что эта структура — 6 байт в длину :)
это даёт понятный код, и огромную простоту при переделке.

6. Хочу много одинаковых повторяющихся кодов и данных вперемешку, потому что у меня тьюринг! МАШЫНА!
отлично!
есть хорошее средство обьединить код и данные в группу — макросы.
вместо определения макроса в код будет подставлено его содержимое.
при этом — для макроса можно задавать входные параметры, что очень удобно.
параметры и содержимое макроса будет лежать в памяти точно так-же, как и привычный код.
Представь себе — что это подпрограмма, в которой можно заменить параметры описанные в заголовке.

приведу макрос, юзаемый мною в демах. он — без кода, и предназначен для указания, какая именно процедура будет вызываться в основном цикле. значимо здесь — номер команды (2), и адрес передаваемой процедуры:

MACRO	_play	addr
		db	2
		dw	addr
		ENDM