pandocs icon indicating copy to clipboard operation
pandocs copied to clipboard

Missing list of MBC types?

Open ReiquelApplegate opened this issue 9 months ago • 2 comments

On https://gbdev.io/pandocs/MBCs.html, is there supposed to be a list after this sentence?

Several MBC types are available:

ReiquelApplegate avatar Mar 01 '25 20:03 ReiquelApplegate

This stems from the original document, where what's now the various MBC sub-pages followed directly.

I agree that a table or list of the MBCs (with links to the pages!) would be useful.

ISSOtm avatar Mar 01 '25 21:03 ISSOtm

Yeah, I agree that phrase there is a bit awkward now

avivace avatar Mar 03 '25 05:03 avivace

If we put in a list of links, we'd need to worry about keeping it updated whenever someone invents a new one, but that's probably rare enough that we don't care? There's that list in the left panel already so I don't really care if we delete this sentence either.

Also, we might want to consider creating an MBC directory to put all these subpages in - would make it easier to autogenerate a list if we choose.

ReiquelApplegate avatar Sep 02 '25 17:09 ReiquelApplegate

Moving the pages to subdirectories is in principle a good idea (not only does it make the src directory less cluttered, sub-dirs could have specific READMEs for instructions like this.

However, mdBook directly takes the output structure from the input, and there's enough pages linking to Pan Docs that I think we'll want to keep the URLs stable. This is something we might be able to patch with a mdBook preproc (or, god forbid, adding even more hacks to the custom renderer).

ISSOtm avatar Sep 02 '25 19:09 ISSOtm