What is this document for?
This document is for drafting an essay for HW2 of the summer course on scientific writing EMSE-7(4 or 3, that is)68
The plan is to use the so-called bottom-up approach
What is a bottom-up approach?
In a bottom-up approach, the writer first lay out information coming to mind freely before grouping the information into the product like an essay or an article (is there a difference between an essay and an article?).
A github page is a webpage lauched through github. It’s free and reliable
Check creating a GitHub Pages site on GitHub docs and GitHub Pages homepage to see information provided by Github.
Yes
When I made this webpage on the Universe, I only found GitHub Pages. What confused me there was how github recognizes the file to render into a webpage. At first I uploaded a file called universe.html. The webpage built from the repository didn’t have the html rendered. Then I realized github looks for index.html. I created a file index.html in the repository. The webpage built from the repository rendered the content in index.html.
To talk about github we need to first talk about git.
Right, what is git? https://github.com/rksm/org-ai
You see, git was invented in 2005. That was fairly recent. It was invented by the inventor of the Linux operating system.
https://github.com/rksm/org-ai
Github is a popular online platform for online code storage, sharing, collaboration, and version control. The second part of the name is hub. What about the first part of the name git?
Git is a version control system invented in 2005. The inventor of git is Linus Torvalds, who created the kernel of the Linux open source operating system in 1991. Linus has since been overseeing the development of the Linux kernel as the chief architect. The development of the Linux operating systems takes an open and inclusive approach, allowing a global community of thousands of developers to contribute. The open source approach makes the development process more efficient and colaborative but it requires an efficient version control system. There were other version control systems available when the development of Linux kernel first started, but Linus wasn’t satisfied with their efficiency. Eventually, Linus created a new version control system, git.
GitHub is a web-based platform based on git. GitHub provides version control and hosting service for software projects. On GitHub developers can contribute to open source projects and share their own code. GitHub made it possible for developers from around the world to work together. Since being founded in Febuary 2008, GitHub has been growing into a central hub for the developers community, hosting millions of repositories for a wide range of projects and programming languages.
Besides as a convenient platform for code sharing and project developing, since 2009, shortly after GitHub was founded, GitHub offers the users a feature called GitHub Pagees. With Github Pages the users can host free web pages through GitHub repositories. GitHub Pages quickly become a popular option for developers to host personal blogs, project documentations, and other types of websites. The integration of GitHub page with GitHub repositories makes it convenient for users to use the version control flow.
So how to launch a webpage through GitHub Pages? Check the instructions in creating a GitHub Pages site on GitHub docs and GitHub Pages homepage. I launched a webpage the Universe by following the steps layed out in the instructions. What was confusing for me at first was how GitHub Pages recognizes with file in the repository to render into a webpage. I thought an html file with any file name would work. It turned out GitHub Pages recognizes a file called index.html as the file to render into a webpage. Otherwise, GitHub Pages would render the readme.md instead.