search

gbdev / awesome-gbdev

A curated list of Game Boy development resources such as tools, docs, emulators, related projects and open-source ROMs.
https://gbdev.io/resources
Other
3.99k stars 177 forks source link

List Review: (3) Documentation #161

Closed avivace closed 4 years ago

avivace commented 4 years ago

See #158 for context

  1. Game Boy Programming Manual - Official Game Boy programming and hardware manual by Nintendo.
  2. Pan Docs - Historical comprehensive technical reference, wikified, corrected and updated.
  3. The Cycle-Accurate Game Boy Docs - A precise documentation by AntonioND to make a cycle-accurate Game Boy emulator.
  4. Game Boy: Complete Technical Reference by Gekkio.
ISSOtm commented 4 years ago
  1. Keep. We keep finding new things in it; also, historical value
  2. Change to the new version?
  3. Isn't it superseded by other documents?
  4. Keep.
avivace commented 4 years ago
  1. Which document (a part from GBCTR) supersedes that?
meithecatte commented 4 years ago
  1. Keep, but mention that despite being official, the docs are sub-par and have mostly historical value.
avivace commented 4 years ago

@NieDzejkob sub-par to what? What other documentation are you thinking of?

ISSOtm commented 4 years ago

In readability and depth.

meithecatte commented 4 years ago

@avivace Pan Docs & the opcode table go a long way. There's also man 7 gbz80 from rgbds.

avivace commented 4 years ago

Semi unrelated: Diagrams from that manual are really good. I've started to port some of them on pan docs.

aaaaaa123456789 commented 4 years ago

1: agreed with above; if you're keeping it here and not moving it to the beginning of the list, mention that it's mostly there for its historical value and not a good reference 2: replace with the new wiki link. I'd still point to the old document, too (not the wiki, but the actual document), because it's been the canonical reference for ages and people would probably still want to be able to find it quickly. 3, 4: not too sure about the quality of these documents; they seem well made, but also outdated. Someone should probably review them.

ISSOtm commented 4 years ago

What would have outdated gb-ctr?