Markdown

See the following -

10 Tips for New GitHub Projects

GitHub has become a fairly central part of many open source projects. Although many people focus on the code-hosting aspect of GitHub, the platform also includes comprehensive features for issue management, code review, and integration with many other tools and platforms. For new open source projects, however, getting started and ensuring that GitHub repos are in tip-top shape and ready to attract new developers can be a little overwhelming. To smooth this transition, here are 10 tips for rocking your octo-project and getting your new project off to a great start...

A Guide to Bootstrapping Your Open Source Project with GitHub

There's much more to managing a project with git beyond just committing code and working with branches. GitHub-Driven Development is a process that will help you organize and manage the progression of a project on GitHub, although much of this could be applied to other systems, such as GitLab, as well. This concept isn't only for developers; it can be used for project managers or anyone involved in the development of a project—it could even be applied to non-code projects...

Writing Documentation with AsciiDoc

I discovered AsciiDoc while writing Learn Linux in a Month of Lunches. AsciiDoc is a fantastically thorough markup language for writing books—think Markdown, but with more options, such as sidebars, notes, and tables. AsciiDoc lets you just type, with simple syntax controlling the formatting. When I first started writing my book, I was using Word style sheets with LibreOffice. Manning, my publisher, offered .odt versions for OpenOffice, but I had trouble getting the styles to work...