Re: Announcement - new QL Interface
Posted: Tue Aug 29, 2017 1:49 pm
Hi Vitaliy!
What a terrific project.
Your guide is actually very clear and the language reads perfectly well in English. Nice work!
However, because you asked for feedback, here are a couple of (very picky!) suggestions:
1. Page 4 - under "Getting up and running" - the term 'logos' is used when in English we use 'logo' for the singular meaning. You might change that, or else choose a different word/phrase altogether, e.g.:
Currently: "A Logos should appear on your screen as follows:"
Suggestion: "The following banners will appear on your screen" or "The following messages will appear on your screen"
Currently: "QUBIDE / QUBATA and / or Floppy disk interface logos, depending of Jumpers settings ( J1 - J3 )."
Suggestion: "QUBIDE / QUBATA and / or Floppy disk interface banners, depending on chosen Jumper settings ( J1 - J3 )." (again, 'banners' or 'messages' would work equally well.)
Currently: "If logos does not appear switch everything off and check the jumpers settings and the connections."
Suggestion: "If the expected banners do not appear, switch everything off and check the jumper settings and the physical connection with the QL."
2. Page 4 - under "TDI ROM Mapping"
Currently: "TDI has 64 Kbytes of ROM, you can use any versions of Trump card and QUBIDE / QUBATA ROM images, according the following mapping :"
Suggestion: "TDI has 64 Kbytes of ROM, for which you can use any version of Trump card and QUBIDE / QUBATA ROM images, according to the following mapping:"
On a technical note, the ROM mapping address table is, at first, a little confusing. You are of course referring to the address ranges _within_ the provided ROM, but those addresses will no doubt get remapped to different addresses within the QL memory map. You might add a short explanatory caption under the table to that effect, e.g.:
"Internal ROM Address ranges - remapped to the appropriate address-space within the QL Memory map"
Any native English speaker will understand how small such suggestions are and, quite frankly, none of the above needs alteration at all!
Again, great work!
M.
What a terrific project.
Your guide is actually very clear and the language reads perfectly well in English. Nice work!
However, because you asked for feedback, here are a couple of (very picky!) suggestions:
1. Page 4 - under "Getting up and running" - the term 'logos' is used when in English we use 'logo' for the singular meaning. You might change that, or else choose a different word/phrase altogether, e.g.:
Currently: "A Logos should appear on your screen as follows:"
Suggestion: "The following banners will appear on your screen" or "The following messages will appear on your screen"
Currently: "QUBIDE / QUBATA and / or Floppy disk interface logos, depending of Jumpers settings ( J1 - J3 )."
Suggestion: "QUBIDE / QUBATA and / or Floppy disk interface banners, depending on chosen Jumper settings ( J1 - J3 )." (again, 'banners' or 'messages' would work equally well.)
Currently: "If logos does not appear switch everything off and check the jumpers settings and the connections."
Suggestion: "If the expected banners do not appear, switch everything off and check the jumper settings and the physical connection with the QL."
2. Page 4 - under "TDI ROM Mapping"
Currently: "TDI has 64 Kbytes of ROM, you can use any versions of Trump card and QUBIDE / QUBATA ROM images, according the following mapping :"
Suggestion: "TDI has 64 Kbytes of ROM, for which you can use any version of Trump card and QUBIDE / QUBATA ROM images, according to the following mapping:"
On a technical note, the ROM mapping address table is, at first, a little confusing. You are of course referring to the address ranges _within_ the provided ROM, but those addresses will no doubt get remapped to different addresses within the QL memory map. You might add a short explanatory caption under the table to that effect, e.g.:
"Internal ROM Address ranges - remapped to the appropriate address-space within the QL Memory map"
Any native English speaker will understand how small such suggestions are and, quite frankly, none of the above needs alteration at all!
Again, great work!
M.