Imho, potential users of this project are likely familiar with FPC, so they don't need explanations on things like FOR loops. The official FPC documentation covers that. Your documentation should only include topics that differ from standard FPC, highlight any missing features that might be expected to exist, or introduce to new features that aren't available in the original FPC.
Let's move this discussion in our GitHub "organization"
Folks here aren't really interested in our somewhat "private" conversation. They're even starting to act weird when the topic of a "custom RTL" comes up and are trying to dissuade you from pursuing it.
EDIT: removed this part cos you removed your edit