Almost 22 years ago Konamiman manually digitized the English version of MSX2 Technical Handbook, converting it to a suite of text files easily readable from any computer. Now he has just released an update to that project by converting these text files to nicely formatted markdown files and hosting them in a Git repository in GitHub. Not only makes this the text even easier to read, it also makes it easier for people to suggest corrections to possible mistakes (by using GitHub's issues and pull requests mechanisms) and to share links to specific sections of the text (like subsection titles, code samples, tables and figures).

If you didn't took a look at this project when it was originally released, now it's a good opportunity to gain some knowledge about the internals of our favorite system!

Relevant link: MSX2 Technical Handbook (repository)
Relevant link: MSX2 Technical Handbook (GitHub pages)

Reacties (9)

Van hamlet

Scribe (3684)

afbeelding van hamlet

10-01-2019, 19:34

Usually I don't read books anymore. But it seems 2019 is going to get a very "book" year!
Thanks again konamiman!

Van TomH

Champion (327)

afbeelding van TomH

10-01-2019, 19:53

This is fantastic!

Query though: what's the proper test for pull requests? E.g. the very first sentence I found was:

"The following features of the MSX-VIDEO give it a better display capabilities than the TMS9918A:"

As a native English speaker I ideally want to eliminate the 'a' but if forced might compromise on just making the 'capabilities' singular. But if what you're looking for is an accurate transcription of the original then, well, I don't have a copy so I don't know, and I don't want to create the burden of someone else having to run off to a source text for every pull request.

So what are your thoughts on copyedits (subject to ad hoc questions of scale and effect, of course) versus mere transcription corrections?

Van ro

Scribe (4483)

afbeelding van ro

10-01-2019, 20:52

I started reading more physical books last couple of years. I have this book as hardcopy, somewhere

Van Grauw

Ascended (10070)

afbeelding van Grauw

10-01-2019, 21:14

Neato! The links from the MAP have been updated Smile.

p.s. I use it often! So thanks!

Van karloch

Prophet (2139)

afbeelding van karloch

10-01-2019, 23:08

Wow, it must have been a lot of work. Thank you Konamiman!


Enlighted (5880)

afbeelding van NYYRIKKI

11-01-2019, 03:30

Oh, this is awesome!

MSX2 Technical Handbook is one of the (if not the) most useful documentation around, but it has always been a bit pain to link to the information inside. Now we don't have this problem anymore! Great work!

Van konamiman

Paragon (1143)

afbeelding van konamiman

11-01-2019, 09:12

TomH wrote:

So what are your thoughts on copyedits (subject to ad hoc questions of scale and effect, of course) versus mere transcription corrections?

Copy edits are welcome if they don't alter the original meaning of the text. The goal of the project is to have useful documentation at hand more than having a 100% exact transcription of the original text (and I already did some corrections when I originally typed the text files 22 years ago).

Van jseb

Rookie (28)

afbeelding van jseb

14-08-2019, 19:45

Thank you for your work. This document is the best for learning MSX2 coding.

Van alexito

Paladin (744)

afbeelding van alexito

15-08-2019, 12:59

Thanks, Konamiman. I saw more info was added that's great.