Version: DRAFT-2015-05-20
##Yaffle's thoughts on documentation...
I've completed converting the existing documentation HTML into markdown. It's available on https://profyaffle.github.io/ and https://tvheadend.readthedocs.org/en/latest/.
Basic structure of pages is now more consistent, as is layout/format. Content varies wildly, from current to rubbish; language is similar, some is clear and some needs re-writing.
The conversion of the webUI-specific (tab) pages seems to be functioning okay as well, so I have write-once, use-many
###Proposed next steps:
Some quick definitions that will help you understand what's going on here:
- A branch is a line of development - maybe a new version, or a new feature that someone is working on. They can be merged back together later.
- A git clone fetches all items that make up a remote project and copies them locally into a new, empty directory on your machine.
- A commit is a specific point in the git history - effectively, a contribution to a branch, or a change affecting one of more chunks of the code.
- A git checkout is when you switch from one part of the code to another, such as between branches or back and forth through the commit history.
- A git fetch finds out what the current HEAD is of whatever you have checked out, and goes and gets any missing objects (files, code, images) for you.
- The HEAD is the tip of whatever branch you currently have checked out. If you've checked out a commit that isn't the HEAD, you have a detached HEAD
- A git merge weaves new objects (m