shoui520 / shoui520.github.io

https://learnjapanese.moe
GNU General Public License v3.0
111 stars 41 forks source link

Update new-guide-preview.md #35

Closed kaionabuco closed 6 months ago

kaionabuco commented 6 months ago

As a first thing, I recommend you make the body of the text justified. I’ve also standardized the em-dashes (—) to have no spaces before or after them, as that is the default in US printing, but you may add spaces as you wish—it is not a grammar rule, but rather a formatting convention. In any case, keep them consistent with each other for a neater document.

Bold for the section titles would make it easier to skim and look up information—it is disorientating to see bold throughout the body of the text when scrolling, because it interrupts the reader who is looking for section breaks. However, I understand if you prefer the neat aesthetic over a more pragmatic design pattern, and in that case, I ask that you at least consider switching from bold to underline for emphasis.

The rest of this first section is alright, though it needs to be standardized. The words hiragana, katakana, kanji, and kana should all be italicized. I don’t know if this only applies to my native language (Portuguese), but the correct punctuation for lists of non-sequential elements is the semicolon at the end of every sentence but the last. Some subsections could also see more context (e.g. the YouTube video could be better described, and preferably embedded).