Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Developer Notebook for Johan Martin

Notes are online at Johan Martin's Development Notes

  • Easier to write things down then trying to remember what you forgot.
  • Working on web development projects is changing rapidly and constantly.
  • Resources are available everywhere but some are outdated and only some help with solving your problem.
  • Easier to review notes on how you solved it last time than googling and going through all the articles again.
  • Too much Googling can lead to a waste of time.
  • Track your development


  • Notes are written in Markdown
    • Using IA Writer and Microsoft Visual Studio Code to edit the docs.
  • Site generated with MkDocs
    • Deciding factor was the ability to push docs to gh-pages on Github.
    • Essentially free hosting for my document notebook.
  • Notes for setting up notebook in notebook.

Creating Project Documentation

Using MkDocs

  • Uses markdown.
  • Works with github pages.
  • Every project will have their own documentation
    • Styleguide should be included (frontend)
    • Project goals and requirements
    • Notes about development
    • Setup/install instructions
    • Resolution to issues (ongoing FAQ for the projects)
  • Documentation pages stay in gh-pages branch.


  • Use pipenv
  1. Create project directory and CD into it
  2. Install mkdocs as dev dependency - pipenv install mkdocs --dev
  3. Create mkdocs direcotry - mkdocs new sitedocs
  • sitedocs\docs is where the markdown goes.
  • sitedocs\mkdocs.yml - your table of contents.


  • mkdocs serve - local development server http://localhost:8000
  • mkdocs gh-deploy - build docs and push to gh-pages repo in github after committing.

Config file - mkdocs.yml

site_name: Development Notes for Johan Martin
site_description: Notes tracking for developing different apps.
site_author: Johan Martin (
repo_name: 'GitHub'
edit_uri: edit/master/md/
# docs_dir: 'md'
# site_dir: 'docs'
copyright: Johan Martin © 2017
  - pymdownx.tilde
theme: 'material'
- Home: ''
- Section:
  - 'Page Sites': ''
  - Section:
      - sub1: ''
      - sub2: ''

MkDocs Notes

Installing Markdown Extensions

Fixing Issues with MkDocs

  • 404 error for home page/front page - github gh-pages hosting.: Seems like the home page has to point to an "" page for it to work.
  • RuntimeError: Click will abort further execution because Python 3 was configured to use ASCII as encoding for the environment. Consult mitigation steps.
  • Fix with:
    • > export LC_ALL=en_US.UTF-8
    • > export LANG=en_US.UTF-8

Importing docs into Github

  • ghp-import
  • Already being used by MkDocs.
  • Would like to use with Sphinx if I convert my documentation to Sphinx.


  • Updated notes about WordPress CLI
  • 24 April 2018 - Added API section. PHP, Python, Node.js frameworks related creating APIs. * Added notes about pipenv
  • 25 April 2018 - Added Jupyter notebook with support for TypeScript, JavaScript and Ruby.

Monday 13 April 2020

  • Refactor documents to simplify and make relevant.
  • Topics
    • Cloud
      • AWS
      • Azure
      • Google
        • Firebase
      • Others
        • Cloudinary
    • Web Development
    • Tools
    • Resources


No releases published


No packages published

Contributors 4