# Documentation

> Discover how I use GitHub and Markdown for technical documentation and code management, streamlining collaboration and version control in projects.

- Canonical: https://www.russ.cloud/2014/07/20/documentation/
- Published: 2014-07-20
- Author: Russ McKendrick
- Tags: Code, Tools

---

<Img src="/assets/2014-07-20-documentation/img/2014-07-20_documentation_0.png" alt="a group of colorful paper" />

I am currently working on a technical project for work where I need to keep a combination of code and technical documentation together, at the moment it is only me working on the project though other people may start to contribute later. Normally on projects like this I dump all of my work in either a [Google Docs ](https://docs.google.com/)document or use files in [Basecamp](http://basecamp.com/) however as this was mostly technical documentation along side snippets of code I decided I wanted to use [Markdown](http://daringfireball.net/projects/markdown/).

I have been using Markdown for quite a while to draft documents so I wanted to do this project using it, however both Basecamps & Google Docs support of Markdown is non-existent, so what to use?

When I first learnt Git I read [Ravishankar Somasundaram’s Git: Version Control for Everyone](http://www.packtpub.com/git-version-control-for-everyone/book) a lot of the examples in the book had you editing documents . Hmmmmmm, I thought, maybe I should try and use [GitHub](https://github.com/)?

I created a private repository and started commit, so far it is going great, I have my basic structure sorted out and it seems to render as expected (using [README.md](https://github.com/russmckendrick/) as index files).

Where large chunks of code are needed I am using external Git repositories and adding them as [Submodules](http://git-scm.com/docs/git-submodule).

I am currently using the following tools to do the work in;

- [ByWord2](http://bywordapp.com/)
- [Sublime Text](http://www.sublimetext.com/)
- [GitHub Mac Client](https://mac.github.com/)
- [GitHub Flavored Markdown](https://help.github.com/articles/github-flavored-markdown)

It will be interesting when more people start to work on the project and start to submit [Pull Requests](https://help.github.com/articles/using-pull-requests).

* * *
Written on July 20, 2014 by Russ Mckendrick.

Originally published on [Medium](https://medium.com/@russmckendrick/documentation-2f190c3d8c44)
