sec-introduction.ptx

<?xml version="1.0" encoding="UTF-8"?>

<!--*****************************************
This is part of Basic Programming
Copyright (C) 2024
Phạm Công Vinh
See the file COPYING for copying conditions.
******************************************-->

<section xml:id="sec-introduction" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Introduction</title>

  <introduction>
    <p>
      Welcome my friend! This is an article on <term>programming</term> and its most <term>fundamental concepts</term>, as you can see in the Table of Contents to your left. The knowledge is designed to be as beginner-friendly as possible, making each section a 5 to 10-minute read.
    </p>
    
    <p>
      <idx><h>Links</h><h>Youtube series</h></idx>
      This article is also adapted into videos, which are available on Youtube and also embedded into the corresponding section. This way, whether you are a visual or auditory learner, or both, you can find the most comfortable way to enjoy this tutorial. (P.S. The videos are short and quite silly because I'm new to editing.)
    </p>

    <p>
      That's it! Going forward I hope I can give you a good first impression of the wonderful world of programming. Despite the title, I hope this article will be useful and entertaining to both complete novices and those who've had minimal contact with programming.
    </p>

  </introduction>

  <subsection xml:id="subsec-how-to-follow-along">
    <title>How To Follow Along</title>
    <idx><h>Overviews</h></idx>

    <p>
      <idx><h>Overviews</h><h>of contents</h></idx>
      An overview of the contents:

      <ul>
        <li>
          <term>Sections 1 and 2</term>: An introduction to the article.
        </li>
        <li>
          <term>Sections 3 to 10</term>: Fundamental concepts of programming.
        </li>
        <li>
          <term>Sections 11 and 12</term>: My personal experiences.
        </li>
        <li>
          <p>
            <term>Sections 13 to 19 (under development, tentative)</term>: Slightly more advanced fundamental concepts.
          </p>
        </li>
      </ul>
    </p>

    <p>
      New concepts will be introduced with the following structure:
      <ol>
        <li>
          Definition
        </li>
        <li>
          Code examples
        </li>
        <li>
          Explanations for examples
        </li>
      </ol>

      When running <em>code examples</em>, you should <term>simultaneously</term> read the corresponding explanations for the best learning experience.
    </p>

    <p>
      You can also watch the videos, before or after reading each section. They have cool visuals and present ideas in a different way.
    </p>

    <p>
      Available languages can be found in <xref ref="colophon" text="title"/>.
    </p>
  </subsection>

  <subsection xml:id="subsec-support">
    <title>Support This Project</title>
    <idx><h>Support</h></idx>
    <p>
      <idx><h>Links</h><h>source code</h></idx>
      This is an open-source project, meaning its source code is available on Github<mdash /><url href="https://github.com/VinhPhmCng/basic-programming-article" visual="github.com/VinhPhmCng/basic-programming-article">here</url>.
    </p>

    <p>
      <idx><h>Support</h><h>directly</h></idx>
      <idx><h>Links</h><h>contributing</h></idx>
      Readers can make a free GitHub account and give feedback and suggestions directly. Or, if you're not familiar with GitHub and its workflow, then you can use these Google Forms instead.

      <ul>
        <li>
          <url href="https://forms.gle/8nunvk918W8TfAtAA" visual="forms.gle/8nunvk918W8TfAtAA">Suggestion Form</url>
        </li>
        <li>
          <url href="https://forms.gle/EsiFz1yGpwsF8KKZ7" visual="forms.gle/EsiFz1yGpwsF8KKZ7">Feedback Form (once per email)</url>
        </li>
      </ul>
    </p>

    <p>
      If you're a programmer and would like to, for example, support your community by translating this article into your language, then that's possible as well. Refer to <url href="https://github.com/VinhPhmCng/basic-programming-article?tab=readme-ov-file#contribute" visual="github.com/VinhPhmCng/basic-programming-article?tab=readme-ov-file#contribute">Contributing</url> for more details. (P.S. I'd really appreciate it if someone could improve my writing. It sucks ass.)
    </p>

    <p>
      <idx><h>Support</h><h>the tools used</h></idx>
      This page is built with <pretext />. Please support them as well!
    </p>

    <p>
      <idx><h>Support</h><h>the videos</h></idx>
      <idx><h>Links</h><h>tools used</h></idx>
      Enjoying the Youtube series is not only an effective way to learn, but also a great way of supporting the project. More details on the tools and resources used to create the videos can be found <url href="https://github.com/VinhPhmCng/basic-programming-article?tab=readme-ov-file#tools-and-resources-used-for-videos" visual="github.com/VinhPhmCng/basic-programming-article?tab=readme-ov-file#tools-and-resources-used-for-videos">here</url>.
    </p>

    <p>
      <idx><h>Support</h><h>by donating</h></idx>
      <idx><h>Links</h><h>donation</h></idx>
      And if you really appreciate the contents, consider leaving a donation <url href="https://www.buymeacoffee.com/vinhpcdevq" visual="buymeacoffee.com/vinhpcdevq">here</url>. Thanks a bunch!
    </p>

    <p>
      OK then, let's get started, shall we?
    </p>
  </subsection>

  <subsection xml:id="subsec-what-is-programming">
    <title>What Is Programming?</title>
    <idx><h>Definitions</h><h>of programming</h></idx>

    <p>
      <cd>
      </cd>
    </p>
    
    <exploration>
      <title>Basic Programming <mdash /> Part 1: Introduction</title>
      <idx><h>Videos</h><h>part 01</h></idx>
      
      <video youtubeplaylist="PLBLdRr-v59vwnKvmvLtcgmAnsb2K1Ta_M" />
       
    </exploration>
  </subsection>

</section>