DEV Community

Cover image for πŸ“3 Simple ways to create a
Abdulrahman Alblooshi
Abdulrahman Alblooshi

Posted on

πŸ“3 Simple ways to create a

First of all, why have a well designed

Having a well designed would give you the following benefits:

  • Makes the project documentation much easier to understand
  • It would give others the impression that your work is organized.
  • It could even help you point out and plan what you want to do with your project
  • It makes your project stand out from other projects

This is an example of a well designed

enter image description here

On the other hand this is an example of a poorly designed

enter image description here


β€œYou're either the one that creates the automation or you're getting automatedβ€œ ~ Tom Preston-Werner

Some developers would rather spend time on the project itself than to spend it on a, this is why automation is a key component here.

Here are a few examples of websites/apps that (almost) automate creating files.

A really simple to use web app that simplifies creating which is so close to automating it compared to the original way of creating files, where you could add templates of sections and it makes it easier to know what to add to your file.

enter image description here

A more minimalistic downloadable app that shows you a live preview of markdown language being written, it's not that much of automation but it helps you visualize what you type in a better way. (Available on Windows/OSX/Linux)

enter image description here

StackEdit is more of a markdown editor than a README.MD automation tool, but the way it's accessible is similar to Microsoft Word or even Google Docs which might be familiar to people who were used to working on those type of platforms.

enter image description here

In conclusion

The key component in making markdown files is finding an easy way to do them which doesn't cost a lot of time, the tools above are examples that could help you as a developer/writer to write a file.

Thank you for reading my article!

Top comments (0)