Skip to main content

Changelog, Readme, Package.json

Version​

MAJOR.MINOR.PATCH - Version Format

  1. MAJOR version when you make incompatible API changes
  2. MINOR version when you add functionality in a backward compatible manner
  3. PATCH version when you make backward compatible bug fixes

Changelog​

  • робимо MR в main
  • виписуємо правки в опис MR - згідно формату changelog
  • додаємо правки в changelog
  • вносимо в package.json
  • фіксуємо версію

Приклади changelog

Readme​

Вимоги

Додатково

Details
# Project Title
A little brief about what the project is about. It should be like a small summary format informing about the main purpose of the project.

# Motivation
This section is for letting the reader know why you created this project, the reason behind pursuing such a project, and why you have decided to do it.

# Build Status
This basically explains the current build status of the project. If there is a bug /error which needs addressing. This is done so for two different reasons The user understands that this is an issue and does not spend more time figuring if it was a mistake on their part.A developer who is familiar with the issue can suggest some solutions directly without going through the whole code.

# Code Style
This lets the users know that you have used a particular code style and helps them when contributing to your project so that the whole project code style stays the same. Some common code styles: standard, xo, etc.

# Screenshots
As the saying goes, a picture is equal to a thousand words. Most people will be interested if there is a visual representation of what the project is about. It helps them understand better. A visual representation can be snapshots of the project or a video of the functioning of the project.

# Tech/Framework used
This is used to help the reader understand which tech or frameworks have been used to do the project. It helps the reader understand which all tech stack he has to be familiar with to understand the whole project.

# Features
This is where you write what all extra features have been done in your project. Basically, this is where you try to make your project stand out from the rest.

# Code Examples
This is where you try to compress your project and make the reader understand what it does as simple as possible. This should help the reader understand if your code solves their issue.

# Installation
If your project needs the installation of certain software or configurations to the system. Do mention it in this section as it helps a lot for the reader to use your project. The steps mentioned should be precise and explanatory.  If possible, you can add links that can help them better understand how to configure/install the necessary files or software.

# API reference
If your project is small, then we can add the reference docs in the readme. For larger projects, it is better to provide links to where the API reference documentation is documented.

# Tests
This is the section where you mention all the different tests that can be performed with code examples

# How to Use?
As I have mentioned before, you never know who is going to read your readme. So it is better to provide information on how to use your project. A step-by-step guide is best suited for this purpose. It is better to explain the steps as detailed as possible because it might be a beginner who is reading it.

# Contribute
This is where you let them know that they can contribute and help you out. A guideline on how to contribute is also helpful

# Credits
Giving proper credit is most important. Mention any links/repos which helped you or inspired you to build this project. It can be a blog, another open source project, or just people who have contributed to building this project.

# License
A short description of the license. (MIT, Apache, etc.)
# Name* 
# Version  + Badges?
# Description*
# Demo?
# TOC - зміст readme
# Visual: Screenshots, video*
# Top Features - шахматка table
# Features *
# Installation * 
# Usage, Code Example, How to Use  - Vue
# Requirements  - (Core1.1,node12+, mapnik6.4+)
# Code Style ?
# Tech/Framework used ? 
# Tests   
# Api Reference - для розробника apidocs
# Documentation 
# Roadmap - next features ?
# Changelog
# Support - community/forum, support, softpro.ua/support
# License
# Troubleshooting ?
# Project Status ?
Project Status

Completed Active/In development On hold Abandoned

Приклади

Package.json​

{
  "name": "foo",                                             // назва
  "version": "1.2.3",                                        // version       
  "description": "A packaged foo fooer for fooing foos",     // description  
  "homepage": "https://github.com/owner/project#readme",     // homepage  
  "keywords":"ключові слова",   
  "man": "./man/doc.1",                                      // doc   
  "license": "ISC",                                          // license   
  "author": "Softpro",                                      
  "repository": {
    "type": "git",
    "url": "https://github.com/npm/cli.git"
  }
}