DEV Community

Cover image for Advance the practical side of your coding skills with CodingStories
Oleksii Nikiforov
Oleksii Nikiforov

Posted on • Updated on • Originally published at

Advance the practical side of your coding skills with CodingStories


In this blog post, I will share with you what coding story is about and how to write your own coding story.


Recently, I've discovered a new and practical way to hone my programming skills. The approach is called CodingStories. Basically, a story is some sort of journey, a day-to-day task that you might do at your work. Usually, a coding story shows some new feature, coding techniques, or code refactoring. Generally, you want to guide a user from a bad place to a better one. After all, we all want to write robust and maintainable code.

If you think about the regular experience of learning something new and practical, you may find that it is hard to find a definitive guide. From time to time, I encounter tutorials and blog posts that resemble something like this:

Alt Text

Sometimes it is frustrating to find an interesting article, but not to be able to reproduce it or learn from it. But, It is nobody's fault 😉. It is hard to describe step-by-step code changes and stick to the topic. CodingStories solves the problem by introducing a useful medium to consume coding stories. From a user perspective, you have a nice and handy UI to go through coding stories and experience how to solve a particular task. Every coding story is based on a git repository. It is essential for a coding story to have a meaningful and clean git history. Additionally, you can always open a coding story locally and work with a git repository on your own.

Writing my first coding story

Before starting coding, I investigated coding.stories - author guide. It gave me somewhat understanding of a coding story and the potential ways I could write one.

My first coding story was about Dependency Inversion Principle (D from SOLID). I started with not terrible but still hardly testable version and gradually improved it to a more testable and clean solution.

Basically, I copied the initial solution and used the copy as a draft version. The draft version was based on the preliminary commit history. It is not final coding story. Anyway, having this draft helped me to understand the solution and project structure better. After that, it is was easy to reproduce the solution one more time.

A coding story author should introduce coding story instructions as part of a commit. So every step is essentially code changes and instructions defined in a dedicated file called

I will not go through the details of the coding story (discount-calculation-story-csharp). Everything you need is there (kinda). I encourage you to try the interactive version, you may find it here:

Source repository:

Alt Text

More coding stories:

Coding story writing principles

Here is a list of principle that I quite valuable after writing my first story:

  • Keep git commit history clean and write concise commits
  • Every commit should compile and pass unit tests
  • Do not try to be perfect, focus on the goal of a coding story
  • Do not hurry to write a coding story from the first try. It is better to figure out how the end solution will look like. Consider writing a coding story at the very end.
  • Try to follow common project structure and code formatting guidelines. Examples can be found at

Writing your first coding story

Study the basics

Here is how to become an author: 🚀

Use a template

I've prepared project template for C# and Java. It helps you to get started and promotes consistent coding story structure among other coding stories.

You can find it here, here is the changelog:

All you need to do is to install it via dotnet-sdk. I've prepared a docker wrapper for those who don't want to install dotnet-sdk, for more details, please see (

dotnet new --install CodingStories.Template::1.3.0
Enter fullscreen mode Exit fullscreen mode

Check that template is installed successfully:

$ dotnet new -l | grep story
Coding Stories Template                       story-java           java        Epam/CodingStories
Coding Stories Template                       story                [C#]        Epam/CodingStories
Enter fullscreen mode Exit fullscreen mode

Scaffold a coding story:

dotnet new story -n MyFirstCodingStory # --no-open-todo --no-devcontainer
Enter fullscreen mode Exit fullscreen mode

The output of the command above:

$ tree
├── global.json
├── MyFirstCodingStory
│   ├── Class1.cs
│   └── MyFirstCodingStory.csproj
├── MyFirstCodingStory.sln
├── MyFirstCodingStory.Tests
│   ├── MyFirstCodingStory.Tests.csproj
│   └── UnitTest1.cs
└── TODO.html
Enter fullscreen mode Exit fullscreen mode

Write a coding story

I've decided to write a coding story on how to write a coding story. Don't you think it is a reasonable thing to do? 🤔 I see you there!

You can find it here:

Source repository:


I hope that I've intrigued you enough to write your first coding story. Let me know what you think!

Top comments (2)

anaumtahira profile image
Anaum Tahira

I've decided to write a coding story on Don't you think it is a reasonable thing to do? I see you there!

You can find it here:

nikiforovall profile image
Oleksii Nikiforov

I don't see the link to the coding story. Could you please share it?