Ashish Jaiswar
Ashish Jaiswar

Ashish Jaiswar

How i create automation documentation using Notion

Photo by Jan Kahánek on Unsplash

How i create automation documentation using Notion

Ashish Jaiswar's photo
Ashish Jaiswar
·Aug 27, 2022·

2 min read

Table of contents

  • Introduction
  • Documentation Tool
  • Notion Template
  • Documentation Template

Introduction

I've been coding for the past 4 years and documentation is one of the important aspects of software development. You must create good documentation for your projects.

Creating documentation can be a boring task for many of you but believe me, it's totally worth it. Documentation is equally important as your code.

Document all the possible things!

Documentation Tool

There are plenty of documentation tools like Confluence, Notion, Evernote, OneNote, etc.

My favorite documentation tool is Notion. It has a clean design, easy to use, and offers some cool features. It's free for personal use. In this article, I will show you how I create my automation projects documentations using Notion.

Notion Template

Notion has awesome built-in templates which can be used for a variety of tasks. I use Docs template to organize all my documents.

Select Template

  1. Create a page in Notion and select templates
  2. Choose Docs template from other section
  3. Click on use this template

    https://cdn.hashnode.com/res/hashnode/image/upload/v1661525675947/wGuT034Qh.png

Modify Template

You can modify this template according to your requirement. I have modified it for my automation projects.

If you want to use my customized version of Docs template you can feel free to use it.

  1. Get my Docs template from here
  2. Click on duplicate

https://cdn.hashnode.com/res/hashnode/image/upload/v1661526139037/JeBueX0yp.png

Documentation Template

In Notion, you can easily create a documentation page and you can share this page within your workspace or share it with the public. You can also use your page as a template so that you don't need to create the base structure of documentation again and again.

Adding a document

  1. Click on New button as shown in the below image to create project documentation.
  2. Add title, tags, project link, and status.
  3. When you add a doc page it will ask you to choose a page template
  4. I have already integrated my customized page template within Work Docs template.

https://cdn.hashnode.com/res/hashnode/image/upload/v1661594517676/KSCCwwWz4.png

Overview of the document page

https://cdn.hashnode.com/res/hashnode/image/upload/v1661594955625/WkVIBX3SX.png

My automation document page consists of the following sections.

  • Title
  • Description
  • Goals
  • Technical Requirements
  • Manual Workflow
  • Automation approach and steps
  • Code
  • Future enhancements

If you have any query/suggetions/feedback please connect with me on twitter or ask me in the comment section.

Like and Follow 😊

Meet you on the next blog. Enjoy Coding ❤

Did you find this article valuable?

Support Ashish Jaiswar by becoming a sponsor. Any amount is appreciated!

See recent sponsors Learn more about Hashnode Sponsors
 
Share this