Skip to content

Commit 69d2c64

Browse files
author
alexeev-prog
committed
docs: update docs
1 parent e0dc361 commit 69d2c64

File tree

2 files changed

+16
-7
lines changed

2 files changed

+16
-7
lines changed

CHANGELOG.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,15 @@
1+
commit e0dc361414ba20087978848081e6228016f708a8
2+
Author: alexeev-dev <[email protected]>
3+
Date: Fri Oct 4 21:53:36 2024 +0700
4+
5+
docs: update docs
6+
7+
commit 3a44d6838e6f0b6a1f0aa3d8cf07e79fd548c7a1
8+
Author: alexeev-dev <[email protected]>
9+
Date: Fri Oct 4 21:53:23 2024 +0700
10+
11+
build.sh
12+
113
commit 3e4247c67c65e74dfe6b14e3d74acf209ccf8cd2
214
Author: alexeev-dev <[email protected]>
315
Date: Fri Oct 4 21:50:44 2024 +0700

docs/ru/article3.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -24,13 +24,10 @@
2424
# Внешний вид библиотеки
2525
Человека встречают по одежке, а open source проект - по его описанию, README. Для того, чтобы пользователь мог понять, что к чему, следует в описании отвечать на следующие вопросы:
2626

27-
Какое назначение проекта? Описание должно быть лаконичным и отражающим суть проекта.
28-
29-
Почему проект полезен? Он должен решать определенные проблемы, поэтому необходимо явно написать о них, чтобы потенциальный пользователь мог понять, будет ли библиотека полезной для него. Нужно выделить преимущества своего решения по сравнению с аналогами, желательно с конкретными цифрами и бенчмарками, иначе потенциальный пользователь установит более эффективную или популярную библиотеку.
30-
31-
Как приступить к работе с библиотекой? Этап с установкой и настройкой библиотеки необходимо описать самым детальным образом. Ведь далеко не всегда то, что очевидно вам — очевидно другим. Решением могут пользоваться люди, у которых совершенно другой опыт. Нужно, чтобы любой желающий, кто хочет установить решение, понял, как это сделать.
32-
33-
Где можно получить дополнительную помощь, если она мне понадобится? Обязательно оставить свои контакты или другую предпочитаемую форму взаимодействия.
27+
1. Какое назначение проекта? Описание должно быть лаконичным и отражающим суть проекта.
28+
2. Почему проект полезен? Он должен решать определенные проблемы, поэтому необходимо явно написать о них, чтобы потенциальный пользователь мог понять, будет ли библиотека полезной для него. Нужно выделить преимущества своего решения по сравнению с аналогами, желательно с конкретными цифрами и бенчмарками, иначе потенциальный пользователь установит более эффективную или популярную библиотеку.
29+
3. Как приступить к работе с библиотекой? Этап с установкой и настройкой библиотеки необходимо описать самым детальным образом. Ведь далеко не всегда то, что очевидно вам — очевидно другим. Решением могут пользоваться люди, у которых совершенно другой опыт. Нужно, чтобы любой желающий, кто хочет установить решение, понял, как это сделать.
30+
4. Где можно получить дополнительную помощь, если она мне понадобится? Обязательно оставить свои контакты или другую предпочитаемую форму взаимодействия.
3431

3532
Можно использовать свой README для ответа на другие вопросы. Например, дальнейшие цели в развитии проекта, информация о лицензиях, важных изменениях в коде.
3633

0 commit comments

Comments
 (0)