nerd-fonts icon indicating copy to clipboard operation
nerd-fonts copied to clipboard

Add `markdownlint` for maintain consistent coding style across the entire project

Open mdsanima opened this issue 1 year ago • 3 comments

Requirements

  • [x] I have searched the issues
  • [x] I have searched the FAQ
  • [x] I have searched the Wiki

The Problem

I've noticed that most of the Markdown files in this project are very chaotically written and do not adhere to standard documentation writing rules in *.md files. My editor shows many errors in these files.

The Solution

Add linter configuration file for Markdown and CommonMark files. This tool is a style checker and formatting tool for the files based on the CommonMark specification. The tool is available as a command line tool and works with Prettier as well.

See the markdownlint repository for more info.

Proposed Fixes

I can create a pull request with the necessary files that will allow you to maintain the markdown files according to the established specifications and perform formatting of all the markdown files in this project. Formatting these files will not change the content of the documents, it will only correct them according to the specifications.

These fixes are intended to maintain consistent style across all Markdown documentation files in this project.

mdsanima avatar Jun 23 '24 13:06 mdsanima

@Finii I hope this helps for the code base docs writing.

mdsanima avatar Jun 23 '24 19:06 mdsanima

This sounds very good! :+1: Please go ahead :-)

Finii avatar Jun 24 '24 07:06 Finii

Great, I'll add a pull request regarding this issue soon.

mdsanima avatar Jun 24 '24 09:06 mdsanima

This issue has been automatically locked since there has not been any recent activity (i.e. last half year) after it was closed. It helps our maintainers focus on the active issues. If you have found a problem that seems similar, please open a new issue, complete the issue template with all the details necessary to reproduce, and mention this issue as reference.

github-actions[bot] avatar Apr 14 '25 00:04 github-actions[bot]