Jekyll2018-07-01T10:15:57+00:00https://docs.maxgoodridge.com/DocumentationThe go to place for all my YouTube tutorial write ups and community driven blog posts.Max Goodridgeyoutube@maxgoodridge.comWelcome to Docs2017-03-22T00:00:00+00:002017-03-22T00:00:00+00:00https://docs.maxgoodridge.com/community/home/welcome-to-docs<p>This is the documentation to go with all my <a href="https://www.youtube.com/channel/UCAx4nmhI7S1RcPiaG-Uw0tg">YouTube videos</a> where I teach programming. You can watch the videos here and read (and copy the code out of) the written version! You can also read posts from the community and even post your own!</p>Max Goodridgeyoutube@maxgoodridge.comThis is the documentation to go with all my YouTube videos where I teach programming. You can watch the videos here and read (and copy the code out of) the written version! You can also read posts from the community and even post your own!Contribution Guidelines2017-03-20T00:00:00+00:002017-03-20T00:00:00+00:00https://docs.maxgoodridge.com/community/contribution-guidelines<p>Have you just learnt about some new technical topic? Do you think others could benefit from that knowledge? Do you want some publicity for sharing that knowledge? You’re in the right place.</p>
<p>If it is your first time contributing, you’ll need to add yourself as an author.</p>
<h2 id="add-yourself-as-an-author-first-time-only">Add Yourself as an Author (first time only)</h2>
<p>Add yourself in the <code class="highlighter-rouge">_data/authors.yml</code> file and add links* that you wish to promote next to your post.</p>
<p>Here is my author template (yes, that one on the left) that you can fill in however you like (all external links are optional).</p>
<div class="language-yml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">author</span><span class="pi">:</span>
<span class="na">name </span><span class="pi">:</span> <span class="s2">"</span><span class="s">Max</span><span class="nv"> </span><span class="s">Goodridge"</span>
<span class="na">avatar </span><span class="pi">:</span> <span class="s2">"</span><span class="s">/assets/images/max.jpg"</span>
<span class="na">bio </span><span class="pi">:</span> <span class="s2">"</span><span class="s">Feel</span><span class="nv"> </span><span class="s">free</span><span class="nv"> </span><span class="s">to</span><span class="nv"> </span><span class="s">contribute</span><span class="nv"> </span><span class="s">to</span><span class="nv"> </span><span class="s">this</span><span class="nv"> </span><span class="s">site</span><span class="nv"> </span><span class="s">by</span><span class="nv"> </span><span class="s">writing</span><span class="nv"> </span><span class="s">a</span><span class="nv"> </span><span class="s">post</span><span class="nv"> </span><span class="s">and</span><span class="nv"> </span><span class="s">opening</span><span class="nv"> </span><span class="s">a</span><span class="nv"> </span><span class="s">pull</span><span class="nv"> </span><span class="s">request</span><span class="nv"> </span><span class="s">on</span><span class="nv"> </span><span class="s">GitHub."</span>
<span class="na">location </span><span class="pi">:</span> <span class="s2">"</span><span class="s">Gloucestershire,</span><span class="nv"> </span><span class="s">UK"</span>
<span class="na">youtube </span><span class="pi">:</span> <span class="s2">"</span><span class="s">https://www.youtube.com/channel/UCAx4nmhI7S1RcPiaG-Uw0tg"</span>
<span class="na">email </span><span class="pi">:</span> <span class="s2">"</span><span class="s">youtube@maxgoodridge.com"</span>
<span class="na">github </span><span class="pi">:</span> <span class="s2">"</span><span class="s">maxg203"</span>
<span class="na">instagram </span><span class="pi">:</span> <span class="s2">"</span><span class="s">maxg303"</span>
<span class="na">linkedin </span><span class="pi">:</span> <span class="s2">"</span><span class="s">max-goodridge-6199bb122"</span>
<span class="na">stackoverflow </span><span class="pi">:</span> <span class="s2">"</span><span class="s">4548304/max-goodridge"</span>
<span class="na">twitter </span><span class="pi">:</span> <span class="s2">"</span><span class="s">@maxg203"</span>
</code></pre></div></div>
<p>* A full list of link types that you may promote is listed in the main site configuration file <code class="highlighter-rouge">_config.yml</code>.</p>
<h2 id="edit-directly-on-github">Edit Directly on GitHub</h2>
<ol>
<li>Go to <a href="https://github.com/maxg203/docs/edit/master/_posts/2017-03-20-contribution-guidelines.md">this page</a> on GitHub.</li>
<li>Copy the <a href="https://jekyllrb.com/docs/frontmatter/">Jekyll front matter</a> from that file.</li>
<li>Create a <a href="https://github.com/maxg203/docs/new/master/_posts">new markdown file</a> right on GitHub. It will expect you to fork the repository, that is fine. Make sure you put the file in the <code class="highlighter-rouge">_posts</code> folder so that your post will show up in the right place on the website.</li>
<li>Paste the previously copied front matter.</li>
<li>Change the <code class="highlighter-rouge">title</code> and <code class="highlighter-rouge">tags</code> to better reflect the technical topic that you want to write about.</li>
<li>Be sure to add <code class="highlighter-rouge">author: Your Name</code> so that your author biography will show up next to your post.</li>
<li>Add your content</li>
</ol>
<h2 id="clone-the-repository">Clone the Repository</h2>
<p>You can also clone <a href="http://github.com/maxg203/docs">the GitHub repository</a>, make your changes and create a pull request. Follow some of the instructions above to ensure your markdown file is in the expected format.</p>
<p>The method is the same as what you would have done on GitHub directly, except that you’ll probably find it easier to make changes in your own development environment.</p>
<h2 id="issues">Issues</h2>
<p>If you find any issues, please feel free to open them in the <a href="https://github.com/maxg203/docs/issues">GitHub issue tracker</a> for this repository.</p>Max Goodridgeyoutube@maxgoodridge.comHave you just learnt about some new technical topic? Do you think others could benefit from that knowledge? Do you want some publicity for sharing that knowledge? You’re in the right place.