<div dir="ltr"><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Dec 27, 2022 at 6:47 PM Anthony Walter via fpc-pascal <<a href="mailto:fpc-pascal@lists.freepascal.org">fpc-pascal@lists.freepascal.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">My idea is to implement a web page system where syntax highlight code is presented like in the Lazarus IDE, and special links are peppered through and explanation of how and why Pascal works by using some example programs. When the user highlights the special link, the relevant source code is highlighted in the syntax window. This then hopefully allows people to understand a bit more about pascal by pairing the explanations with lines of source code.<div><br></div><div>Let me know if you think this approach has any merit or if you think my guide could be altered to be a bit more clean in places. As a reminder, this page is a wiki, so you cna submit edits to me by clicking the edit link at the top of the page. I am able to see and merge your edits.</div></div></blockquote><div><br></div><div>I like the concept implemented in this guide.  A small problem I noticed is when the source code snippet linked to is not visible, clicking the link does not move the code snippet into view. This is obviously a tricky situation since moving the code into view may require shifting the rest of the document, which may not be desirable.</div><div><br></div><div>Explaining the layout and structure of a Pascal program using an example is a good idea. However, the example topic is quite advanced so a non-programmer would probably be completely lost regarding the purpose of the code itself.  Programmers from other languages may also not understand the concept of a form or the Application instance.  As suggested, perhaps the example itself should be simple enough so that a non-programmer can understand the intention of the code.<br></div></div></div>