Documentation Creation

I will always tell people that I love documentation. The only issue with documentation, about the time that you publish it, its pretty well out of date already. It is constant cycle to create, verify and publish back to verify and publish again. I have been working between this blog for creation of my own content along with my GitHub repos. One of the other items is giving this documentation out one way or another either via links or what ever, works pretty well. Today I asked myself how would it be to have a method to have your markdown files that are stored in GitHub to convert them to PDF in order to give a person a PDF copy if required or for other reasons. Today I worked on just that. I have setup a process to uses a couple of free tools all via command like to take that markdown file and export it out to PDF. I have also set it up to create a basic cover page and also create a table of contents. The formatting may not be perfect but its something to work on, but as with anything in life, nothing is ever really done. Head on over to my GitHub repo and take a look and maybe it might help you out. I love the fact of creation of the documents in markdown and then the ability to push them to a SharePoint site in order for others to view that content. Maybe it redundant or not, but just something that might help someone out. Till next time.

Leave a comment