Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merge Beta to Main #104

Merged
merged 216 commits into from
Dec 15, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
216 commits
Select commit Hold shift + click to select a range
16bdf33
update
thinh-vu Sep 23, 2023
0aacd23
Create python_data_analysis_course_4_thinhvu.png
thinh-vu Sep 23, 2023
7cb7660
Update README.md
thinh-vu Sep 23, 2023
f967ade
update readme
thinh-vu Sep 23, 2023
703db7a
Update README.md
thinh-vu Sep 23, 2023
19132bb
update readme
thinh-vu Sep 27, 2023
bcd2bab
Merge branch 'main' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Sep 27, 2023
8a1c1f8
update banner
thinh-vu Sep 27, 2023
9eee9fe
Update vnstock._appscript.js
thinh-vu Sep 28, 2023
828cbe8
Update README.md
thinh-vu Oct 2, 2023
f8eecd7
update docs
thinh-vu Oct 6, 2023
85c5b24
minor updates
thinh-vu Oct 6, 2023
5b8147a
update
thinh-vu Oct 6, 2023
0bdd906
minor updates
thinh-vu Oct 6, 2023
235d668
minor updates
thinh-vu Oct 6, 2023
bab6e2f
Update resources.md
thinh-vu Oct 6, 2023
694c9d6
minor updates
thinh-vu Oct 6, 2023
a622972
update docs
thinh-vu Oct 6, 2023
f33128a
minor updates
thinh-vu Oct 6, 2023
ef162df
UPDATE
thinh-vu Oct 6, 2023
fbaa8dc
Update _config.yml
thinh-vu Oct 6, 2023
7de40ed
update
thinh-vu Oct 6, 2023
3962f65
update
thinh-vu Oct 6, 2023
b93629d
update
thinh-vu Oct 6, 2023
5b8bfa3
Update index.md
thinh-vu Oct 6, 2023
330c2af
Merge branch 'main' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 6, 2023
0e9864c
update docs
thinh-vu Oct 6, 2023
44ca61d
minor update
thinh-vu Oct 6, 2023
c997e77
Update README.md
thinh-vu Oct 6, 2023
e33f057
Update intro.md
thinh-vu Oct 6, 2023
1df9cb8
update
thinh-vu Oct 6, 2023
b010c99
Update README.md
thinh-vu Oct 6, 2023
c853607
Update README.md
thinh-vu Oct 6, 2023
c9cdf87
Merge branch 'main' into beta
thinh-vu Oct 6, 2023
cbfb1cb
minor update
thinh-vu Oct 6, 2023
79ced3e
Merge branch 'beta' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 6, 2023
5c8a012
Update derivative.md
thinh-vu Oct 6, 2023
3a9cb1d
update
thinh-vu Oct 6, 2023
c7822c4
Create CNAME
thinh-vu Oct 6, 2023
d46c699
Delete CNAME
thinh-vu Oct 6, 2023
c27eac4
Create CNAME
thinh-vu Oct 6, 2023
a01e42a
Delete CNAME
thinh-vu Oct 6, 2023
6bd688d
Update general.md
thinh-vu Oct 6, 2023
a974211
Merge branch 'beta' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 6, 2023
a2e5477
update
thinh-vu Oct 6, 2023
5915304
Update credits.md
thinh-vu Oct 6, 2023
03d0e5b
enhance docs
thinh-vu Oct 6, 2023
dff7b73
update
thinh-vu Oct 6, 2023
b9e7864
minor update
thinh-vu Oct 6, 2023
9b1032f
update docs
thinh-vu Oct 6, 2023
7d99d8b
update
thinh-vu Oct 6, 2023
5771086
update docs
thinh-vu Oct 6, 2023
a0b28a9
update
thinh-vu Oct 6, 2023
e6e7135
Update README-en.md
thinh-vu Oct 6, 2023
0a948c6
Update README-en.md
thinh-vu Oct 6, 2023
06836f9
Update README-en.md
thinh-vu Oct 6, 2023
f7bf8ed
Merge branch 'main' into beta
thinh-vu Oct 6, 2023
9d18b58
Delete vnstock-test_notebook.ipynb
thinh-vu Oct 6, 2023
ce80330
update
thinh-vu Oct 6, 2023
e783da8
Merge branch 'beta' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 6, 2023
328a6b9
update
thinh-vu Oct 6, 2023
c67e968
Update index.md
thinh-vu Oct 6, 2023
b1e2fdd
Update contributing.md
thinh-vu Oct 6, 2023
ce84ab3
add sitemap for vnstock docs
thinh-vu Oct 6, 2023
3e52962
Create CNAME
thinh-vu Oct 6, 2023
39ea0e3
Update _config.yml
thinh-vu Oct 6, 2023
c9a4969
Merge branch 'beta' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 6, 2023
c3a117c
update docs
thinh-vu Oct 7, 2023
ce168be
Update general.md
thinh-vu Oct 7, 2023
b46f85a
Update pricing.md
thinh-vu Oct 7, 2023
1944c7c
Update pricing.md
thinh-vu Oct 7, 2023
aa525f5
update
thinh-vu Oct 8, 2023
3cd8c19
Update derivative.md
thinh-vu Oct 8, 2023
4fe94b5
Update charts.md
thinh-vu Oct 8, 2023
ea6134b
Update _config.yml
thinh-vu Oct 8, 2023
3ca3042
update
thinh-vu Oct 8, 2023
e877462
update
thinh-vu Oct 9, 2023
2cab432
update
thinh-vu Oct 9, 2023
4b6c47e
Update fundamental.md
thinh-vu Oct 9, 2023
3bc0c7e
Update fundamental.md
thinh-vu Oct 9, 2023
f7b26ef
Update fundamental.md
thinh-vu Oct 9, 2023
106acde
Update technical.md
thinh-vu Oct 9, 2023
ac12af9
Update trading.md
thinh-vu Oct 9, 2023
9eb0f8e
update
thinh-vu Oct 9, 2023
1bcb8db
Update showcase.md
thinh-vu Oct 9, 2023
c11e052
update docs and function
thinh-vu Oct 10, 2023
757e328
update
thinh-vu Oct 10, 2023
434c56f
Update index.md
thinh-vu Oct 10, 2023
88dec38
update candlestick charting capabilities
thinh-vu Oct 10, 2023
edabe28
update
thinh-vu Oct 10, 2023
4131d9d
update
thinh-vu Oct 10, 2023
d773140
update
thinh-vu Oct 10, 2023
432b61d
Update features.md
thinh-vu Oct 10, 2023
a1bd20f
Update features.md
thinh-vu Oct 10, 2023
5467175
update
thinh-vu Oct 11, 2023
6832db3
update docs
thinh-vu Oct 11, 2023
a2bc6d0
Update chart.md
thinh-vu Oct 11, 2023
8d87750
Update chart.md
thinh-vu Oct 11, 2023
59895b8
Update resources.md
thinh-vu Oct 11, 2023
4f59845
Switch data stream for GA4
thinh-vu Oct 11, 2023
665f090
Update _config.yml
thinh-vu Oct 11, 2023
a456c92
Update components.md
thinh-vu Oct 11, 2023
2e5cc60
Update _config.yml
thinh-vu Oct 11, 2023
ee82f7c
Update _config.yml
thinh-vu Oct 11, 2023
96ce831
Update contributing.md
thinh-vu Oct 11, 2023
eb589af
Update contributing.md
thinh-vu Oct 11, 2023
11e3969
Update contributing.md
thinh-vu Oct 11, 2023
bea6355
update docs
thinh-vu Oct 14, 2023
af1b34b
update version 0.2.2 to fix bugs, commit charting features to the mai…
thinh-vu Oct 14, 2023
e861ace
Merge branch 'main' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 14, 2023
b79f07d
update docs
thinh-vu Oct 15, 2023
bcb2639
Update technical.py
thinh-vu Oct 15, 2023
bf2bc69
Update gen2_vnstock_demo_index_all_functions_testing_2023.ipynb
thinh-vu Oct 15, 2023
3ab4858
Merge branch 'main' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 15, 2023
42a1dab
update readme
thinh-vu Oct 16, 2023
615a692
Update README.md
thinh-vu Oct 16, 2023
1080e5d
Update README.md
thinh-vu Oct 16, 2023
d72417b
Update README.md
thinh-vu Oct 16, 2023
a9c6d88
Update README.md
thinh-vu Oct 16, 2023
ede538a
Update README.md
thinh-vu Oct 16, 2023
7f98421
Update README.md
thinh-vu Oct 16, 2023
f7be85c
Update disclaimer.md
thinh-vu Oct 17, 2023
6f452b9
update docs
thinh-vu Oct 19, 2023
d8d3b32
update docs
thinh-vu Oct 19, 2023
8af8796
update page
thinh-vu Oct 19, 2023
de63122
update docs
thinh-vu Oct 19, 2023
2c95865
Update mkdocs.yml
thinh-vu Oct 19, 2023
cb7b7fb
update
thinh-vu Oct 19, 2023
895285f
update
thinh-vu Oct 19, 2023
3c776f2
update docs
thinh-vu Oct 20, 2023
caf4fdf
Update README.md
thinh-vu Oct 20, 2023
bb774a2
Update README.md
thinh-vu Oct 20, 2023
1633c40
Merge branch 'main' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 20, 2023
d2e5be3
update
thinh-vu Oct 20, 2023
feb326a
update docs
thinh-vu Oct 20, 2023
be0fbe5
update docs
thinh-vu Oct 20, 2023
d14294b
update
thinh-vu Oct 20, 2023
58b44ad
update
thinh-vu Oct 20, 2023
779e6da
update docs
thinh-vu Oct 21, 2023
85e431d
update docs
thinh-vu Oct 24, 2023
4e18098
update docs
thinh-vu Oct 24, 2023
0252d7e
update docs
thinh-vu Oct 24, 2023
e12e164
update docs
thinh-vu Oct 25, 2023
121ce23
update docs
thinh-vu Oct 25, 2023
eb505c5
update docs
thinh-vu Oct 25, 2023
004774f
update docs
thinh-vu Oct 26, 2023
11bfd69
Update version 0.2.4
thinh-vu Oct 26, 2023
67a6348
Merge branch 'main' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 26, 2023
6e8470d
Update pricing.md
thinh-vu Oct 26, 2023
97bb964
update
thinh-vu Oct 27, 2023
bc0ef67
update docs
thinh-vu Oct 27, 2023
874f1a8
Revert "update docs"
thinh-vu Oct 27, 2023
5a467cc
Update changes_log.md
thinh-vu Oct 27, 2023
f1fe59c
update
thinh-vu Oct 27, 2023
6aae235
Update listing.md
thinh-vu Oct 27, 2023
7351b41
Update gen2_vnstock_demo_index_all_functions_testing_2023.ipynb
thinh-vu Oct 27, 2023
0331644
Update gen2_vnstock_demo_index_all_functions_testing_2023.ipynb
thinh-vu Oct 27, 2023
3cd6a9e
Merge branch 'main' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Oct 27, 2023
c763207
Update changes_log.md
thinh-vu Oct 27, 2023
4d8af09
release v0.2.6 + update documentation
thinh-vu Oct 29, 2023
cc19029
Update dnse_api.md
thinh-vu Oct 29, 2023
7402c8f
Update dnse_api.md
thinh-vu Oct 29, 2023
e3ad3db
update code
thinh-vu Oct 29, 2023
9f52e33
update docs
thinh-vu Oct 30, 2023
71fec0c
Complete DNSE Lightspeed API integration, updated docs
thinh-vu Nov 5, 2023
41d5699
update docs
thinh-vu Nov 5, 2023
3a3ef3d
Update changes_log.md
thinh-vu Nov 5, 2023
0c7bf6a
update dnse functions
thinh-vu Nov 5, 2023
bd2fe84
Update setup.cfg
thinh-vu Nov 5, 2023
8935383
update function & docs
thinh-vu Nov 8, 2023
a2e8418
Update setup.cfg
thinh-vu Nov 8, 2023
0d2ccc6
update
thinh-vu Nov 8, 2023
c98f070
update
thinh-vu Nov 8, 2023
47a3b9b
Update technical.py
thinh-vu Nov 8, 2023
5a1fa86
update v0.2.8.4
thinh-vu Nov 9, 2023
7414b09
update docs. Release version 0.2.8.5
thinh-vu Nov 9, 2023
562a9a4
Update python_data_analysis_course_4_thinhvu.png
thinh-vu Nov 9, 2023
f82e979
update
thinh-vu Nov 9, 2023
b6abd67
Merge branch 'main' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Nov 9, 2023
5fe0f9b
Update ta_lib_colab_demo.ipynb
thinh-vu Nov 9, 2023
b44cc07
update
thinh-vu Nov 9, 2023
3d64aaf
Update amibroker.md
thinh-vu Nov 9, 2023
a035455
minor
thinh-vu Nov 10, 2023
fce4f02
Create mutual_funds.py (#89)
andrey-jef Nov 29, 2023
f26654b
update funding
thinh-vu Dec 1, 2023
2e39c39
Merge branch 'main' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Dec 1, 2023
8474ee2
Update config.py (#90)
andrey-jef Dec 2, 2023
d4b084b
update docs
thinh-vu Dec 3, 2023
c326b97
update docs
thinh-vu Dec 3, 2023
58192a7
update sponsor
thinh-vu Dec 3, 2023
1fb4dca
update
thinh-vu Dec 3, 2023
f4b069b
update
thinh-vu Dec 3, 2023
c7a3979
Update cite.md
thinh-vu Dec 8, 2023
084e9ad
update
thinh-vu Dec 10, 2023
27469c5
update functions for mutual fund
thinh-vu Dec 10, 2023
0992d43
update fund & docs
thinh-vu Dec 10, 2023
8377ee5
refactor: replace if else statement by dictionary lookup for better c…
andrey-jef Dec 11, 2023
dfb4322
chores: remove unused code and not related comments
andrey-jef Dec 11, 2023
34ecdea
refactor: reassign data type of column id to int; reorder lines for b…
andrey-jef Dec 11, 2023
ccb5e47
feat: add optional input param mode and decor for funds_listing
andrey-jef Dec 12, 2023
ab475fe
feat: add utils function to convert unix timestamp
andrey-jef Dec 12, 2023
80f4cc7
fix: patch bug of convert timestamp
andrey-jef Dec 12, 2023
90f1ad2
Refactor: funds listing() (#99)
andrey-jef Dec 13, 2023
0228b11
refactor: fund_details
andrey-jef Dec 13, 2023
168eb3e
refactor: fund_filter
andrey-jef Dec 13, 2023
5206ae9
refactor: fund_top_holding
andrey-jef Dec 13, 2023
8308802
refactor: fund_nav_report
andrey-jef Dec 13, 2023
187cb44
Merge branch 'andrey-jef-feat/funds/refactor-fund-details' into beta
thinh-vu Dec 13, 2023
e295949
Merge branch 'beta' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Dec 13, 2023
b7c087f
test: unit test for funds_listing (#101)
andrey-jef Dec 13, 2023
54f9188
update docs for basic openbb terminal integration
thinh-vu Dec 13, 2023
19a05f4
Merge branch 'beta' of https://github.com/thinh-vu/vnstock into beta
thinh-vu Dec 13, 2023
63818a1
Update resources.md
thinh-vu Dec 14, 2023
4e7b245
Created using Colaboratory
thinh-vu Dec 14, 2023
d951ba2
Update docs and merge commit
thinh-vu Dec 15, 2023
2ee110f
Merge branch 'main' into beta
thinh-vu Dec 15, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 0 additions & 11 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -1,13 +1,2 @@
# These are supported funding model platforms

github: [thinh-vu]
patreon: # Replace with a single Patreon username
open_collective: # Replace with a single Open Collective username
ko_fi: # Replace with a single Ko-fi username
tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
liberapay: # Replace with a single Liberapay username
issuehunt: # Replace with a single IssueHunt username
otechie: # Replace with a single Otechie username
lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
custom: ["https://paypal.me/thinhvuphoto"]
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -29,3 +29,4 @@ dist/vnstock-0.1.9.5-py3-none-any.whl
dist/vnstock-0.1.9.5.tar.gz
visualize_downloads.ipynb
vnstock_download_pypi_stats.csv
docs/.obsidian
Empty file added CONTRIBUTORS.md
Empty file.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div align="center">

[![python_course_4](https://raw.githubusercontent.com/thinh-vu/vnstock/beta/docs/docs/assets/images/python_data_analysis_course_4_thinhvu.png)](https://thinhvu.com/2023/08/09/phan-tich-du-lieu-voi-python-for-data-analysis-3/)
[![python_course_4](https://raw.githubusercontent.com/thinh-vu/vnstock/beta/docs/docs/assets/images/python_course_5_build_your_own_trading_bot_from_scratch.png)](https://thinhvu.com/2023/08/09/phan-tich-du-lieu-voi-python-for-data-analysis-3/)

</div>

Expand Down
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file removed docs/.cache/plugin/social/Roboto-Black.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-BlackItalic.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-Bold.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-BoldItalic.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-Italic.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-Light.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-LightItalic.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-Medium.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-MediumItalic.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-Regular.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-Thin.ttf
Binary file not shown.
Binary file removed docs/.cache/plugin/social/Roboto-ThinItalic.ttf
Binary file not shown.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
2 changes: 1 addition & 1 deletion docs/docs/blog/index.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
# Kiến thức chung
# Kiến thức

7 changes: 7 additions & 0 deletions docs/docs/changes_log.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Lịch sử cập nhật

## 10-12-2023
- Bổ sung tính năng truy xuất dữ liệu quỹ mở từ fmarket.vn, phát triển từ mã nguồn do `andrey_jef` đóng góp. Tài liệu mô tả và demo notebook đã được cập nhật tương ứng.
- Đưa `plotly` thành thư viện tùy chọn, chỉ phải import vào dự án nếu người dùng có nhu cầu sử dụng tính năng vẽ đồ thị. Việc này giúp vnstock chạy trên môi trường khác Google Colab không cần cài đặt thêm `plotly` theo mặc định. Mã nguồn được cập nhật lên bản beta trên Github, thay đổi sẽ được đẩy lên PyPI trong tuần tới.
- Cập nhật tài liệu hướng dẫn cho nội dung lấy dữ liệu giá lịch sử.
- Cập nhật tài liệu hướng dẫn cách cài đặt thư viện TA-Lib cho phân tích kỹ thuật trên máy tính Windows.


## 09-11-2023
> Phát hành phiên bản 0.2.8.5

Expand Down
6 changes: 4 additions & 2 deletions docs/docs/cite.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,16 @@ Mã nguồn được lấy từ Vnstock - gói phần mềm Python phân tích t

## Giấy phép

### Tiếng Việt

Vnstock được cấp phép theo Giấy phép MIT. Nội dung của giấy phép như dưới đây, và thể hiện trong file [LICENSE](https://github.com/thinh-vu/vnstock/blob/beta/LICENSE).

Khi sử dụng Vnstock trong dự án của mình, bạn phải tuân thủ và giữ nguyên giấy phép MIT của Vnstock. Đồng thời, hãy chắc chắn rằng bạn đã bao gồm tên tác giả và giấy phép trong dự án của bạn.

Lưu ý: Vnstock là một dự án mã nguồn mở, do đó việc tuân thủ giấy phép và trích dẫn đóng vai trò quan trọng trong việc hỗ trợ và duy trì cộng đồng nguồn mở.

Cảm ơn bạn đã sử dụng Vnstock và tuân thủ các hướng dẫn **Trích dẫn** và **Giấy phép** này. Nếu bạn có bất kỳ câu hỏi hoặc góp ý nào, xin vui lòng liên hệ với tôi qua mục [Thảo luận](https://github.com/thinh-vu/vnstock/discussions) của repo Github này hoặc nhắn tin trực tiếp.

### Tiếng Việt

```
Bản quyền (c) 2022 Thinh Vu | thinh-vu @ Github | MIT

Expand Down
82 changes: 56 additions & 26 deletions docs/docs/community/contribute.md
Original file line number Diff line number Diff line change
@@ -1,47 +1,77 @@
# Đóng góp cộng đồng
# Đóng góp mã nguồn

Bạn có thể đóng góp vào dự án Vnstock bằng nhiều cách như dưới đây.
!!! abstract "Lời nói đầu"
Cám ơn bạn đã quan tâm đến việc đóng góp mã nguồn cho dự án Vnstock. Bạn có thể chọn nhiều hình thức đóng góp khác nhau, trong đó bao gồm nhưng không giới hạn các việc như xây dựng và cải tiến mã nguồn hoặc dịch tài liệu của dự án.

## Lan toả vnstock
- Cách thức đầu tiên đơn giản và dễ áp dụng nhất cho bất kỳ ai yêu thích **vnstock** là góp phần lan tỏa nó tới bạn bè, cộng đồng về trải nghiệm của mình và chia sẻ về cách **vnstock** có thể giúp đơn giản hóa workflow phân tích dữ liệu chứng khoán của những người xung quanh trong cả công việc nghiên cứu lẫn đầu tư thực tế.
- Các hình thức lan tỏa và ủng hộ tinh thần cho **vnstock** bao gồm nhưng không giới hạn
- Đánh dấu yêu thích dự án trên Github với tính năng **Star** ở trên
- **Folk** dự án để bắt đầu tùy biến mã nguồn của dự án, đồng thời lan tỏa sự chú ý nhiều hơn cho **vnstock**.
- Like fanpage vnstock trên Facebook: [vnstock.official](https://www.facebook.com/vnstock.official)
- Theo dõi và chia sẻ cảm nghĩ của bạn qua bình luận trên Youtube channel [LEarn Anything](https://www.youtube.com/@learn_anything_az). Mình có series hướng dẫn sử dụng cụ thể về vnstock cùng nhiều kiến thức hữu ích khác.
- Tham gia cộng đồng [Discord vnstock](https://discord.gg/qJvxJcChJ3) để trao đổi và học hỏi lẫn nhau.
## Triết lý thiết kế

## Chia sẻ trải nghiệm
Hầu hết mã nguồn Vnstock cho đến thời điểm 11/2023 đều do một mình tác giả phát triển và thực sự đây là một nỗ lực rất lớn với khối lượng công việc khổng lồ. Nhằm tối ưu hóa nguồn lực và tập trung vào những điều có giá trị, những ưu tiên và triết lý thiết kế Vnstock được tôi sử dụng như sau:

>vnstock là một dự án tôi tâm huyết, đầu tư nhiều thời gian để phát triển giúp bản thân và cộng đồng tiếp cận nguồn dữ liệu chứng khoán miễn phí và đáng tin cậy.
1. **DỄ DÀNG, THUẬN TIỆN:** Vnstock được thiết kế phục vụ đối tượng người dùng đa dạng, giúp phổ biến công cụ này tới cả những người không có kiến thức lập trình từ trước. Nguyên tắc ngày giúp ai cũng đều có thể nhanh chóng sử dụng Vnstock (tương tự như gọi các hàm Excel, chỉ khác chút là trong môi trường Python).
2. **THẤU HIỂU NGƯỜI DÙNG** (end-user): Để làm rõ hơn ý 1 ở trên, các tính năng mà Vnstock cung cấp hướng đến đối tượng người dùng cuối (ít hoặc chưa có kiến thức lập trình), do đó trong quá trình phát triển tính năng, tôi cố gắng đặt mình vào vị trí và góc nhìn của người dùng cuối để tạo ra những trải nghiệm sử dụng thân thiện và dễ dàng. Nếu bạn đóng góp mã nguồn để giúp chính mình sử dụng thuận tiện cho công việc cũng không sao. Tôi sẽ cùng bạn tối ưu thêm các bước cần thiết để chúng thân thiện hơn với số đông người dùng.
3. **TÍNH NĂNG ĐA DẠNG**: Tôi ưu tiên tăng độ phủ các tính năng và nguồn cấp dữ liệu để giúp Vnstock đáp ứng nhu cầu đa dạng của người dùng trong khi nguồn lực phát triển hạn chế. Do đó, các tính năng có thể chưa hoàn toàn tối ưu, và sẽ được cải tiến thêm qua thời gian để tối ưu hiệu suất sử dụng.
4. **"SURVIVE, THEN THRIVE"**: Các nguồn cấp dữ liệu hiện tại của Vnstock có được thông qua thủ thuật Web Scraping, việc này không đảm bảo việc tồn tại lâu dài của nguồn cấp dữ liệu bởi nhà cung cấp có thể ngăn chặn hoặc từ chối hoàn toàn truy cập của bạn. Do đó, hãy đảm bảo rằng tính năng được xây dựng có thể sống sót an toàn trước khi bỏ quá nhiều công sức vào việc tối ưu tận gốc nhưng bỗng dưng một ngày bạn nhận ra mình là "Dã tràng xe cát biển Đông" khi tính năng mình xây dựng bị ngưng hoạt động.

Để đảm bảo rằng vnstock phát triển theo hướng đáp ứng nhu cầu của bạn, tôi rất mong nhận được phản hồi từ bạn. Bạn là người dùng quan trọng của vnstock và ý kiến của bạn sẽ giúp chúng tôi xây dựng một kế hoạch phát triển vnstock một cách toàn diện. Bạn hãy dành ra 5 phút để hoàn thành bản khảo sát này. Cảm ơn bạn rất nhiều!
## Hướng phát triển Vnstock

<iframe src="https://docs.google.com/forms/d/e/1FAIpQLSej7ZR8Q2S15yHWmgWWE8eXvyyhUo2sD3aicoeC_c6SJQSV2A/viewform?embedded=true" width="1024" height="800" frameborder="0" marginheight="0" marginwidth="0">Đang tải…</iframe>
> Bạn có thể đóng góp tính năng mình cảm thấy cần thiết hoặc phù hợp với những gì vnstock hiện có. Vnstock không chỉ dừng lại ở một gói phần mềm truy xuất dữ liệu hay chỉ giới hạn với chứng khoán Việt Nam mà mục tiêu lớn nhất là phục vụ người Việt, và do người Việt phát triển.

## Báo lỗi
Đảm bảo rằng bạn đã kiểm tra trên trang [Issues](https://github.com/thinh-vu/vnstock/issues) xem vấn đề của bạn đã được đề cập trước đó chưa.
Dưới đây là các nhóm thông tin/tính năng bạn có thể tham khảo để phát triển.

Nếu chưa, hãy tạo một issue mới để báo cáo lỗi hoặc yêu cầu tính năng. Vui lòng cung cấp một mô tả chi tiết về vấn đề của bạn, bao gồm các bước để tái tạo vấn đề (nếu có thể) và ảnh chụp mành hình lỗi. Các báo lỗi mơ hồ sẽ không được xem xét.
### Truy xuất dữ liệu
- Dữ liệu kinh tế vĩ mô
- Tin tức báo chí, sự kiện: giúp các bạn làm nghiên cứu theo hướng định lượng tiếp cận dữ liệu dễ dàng hơn.
- Dữ liệu giao dịch quỹ, tiền tệ, hàng hóa, crypto, chứng quyền, vv
### Tính toán
- Tính toán các chỉ báo kỹ thuật, mô hình nến, điểm mua/bán, vv dựa trên tiêu chuẩn dữ liệu Vnstock đang cung cấp
- Xử lý ngôn ngữ tự nhiên, phân loại sự kiện, vv
### Biểu diễn dữ liệu
- Cung cấp các phương thức giúp trực quan hóa dữ liệu và tìm cơ hội đầu tư/nghiên cứu nhanh chóng. Trước tiên, đưa các trải nghiệm và tính năng quen thuộc với số đông từ các phần mềm phân tích khác sang Vnstock để thúc đẩy việc phổ biến Vnstock tới cộng đồng.
- Cung cấp các data app mẫu, ví dụ Streamlit để khuyến khích cộng đồng phát triển thêm tính năng và sử dụng.
### Tích hợp
- Tích hợp với các thư viện uy tín, sẵn có trong hệ sinh thái Python
- Tích hợp tính năng liên kết với các đối tác cung cấp dịch vụ, ví dụ SSI và fc_data
### AI & ML
- Sử dụng Vnstock trong các dự án về máy học và AI trong thực tế đồng thời tạo ra các tính năng giúp việc triển khai Vnstock vào nhóm công việc này dễ dàng hơn.
### Tự động hóa và bot
- Xây dựng các tính năng giúp triển khai Vnstock dưới dạng Bot hoặc dự án tự động phục vụ cho việc cảnh báo/hoặc tham gia một phần trong việc xây dựng chương trình giao dịch tự động.
### Hướng dẫn (demo & tutorial)
- Cung cấp các ví dụ sinh động và cách sử dụng Vnstock hiệu quả trong thực tế giúp cộng đồng học hỏi và tiếp cận các phương pháp tiên tiến.

## Đóng góp mã nguồn
## Khởi động

* Gợi ý: Các bạn có thể tham khảo mục Cộng đồng Vnstock để nắm rõ hơn tiêu chuẩn và hướng dẫn đóng góp mã nguồn dự án.
> Tôi tin là tới đây, bạn đã đủ thông tin để bắt đầu hành trình code dạo cùng Vnstock. Dưới đây là những hướng dẫn giúp bạn bắt đầu dễ dàng hơn.

- Bạn có thể đóng góp xây dựng vnstock thông qua nhiều hình thức khác nhau, trong đó có việc xây dựng và cải tiến mã nguồn hoặc dịch tài liệu của dự án.
- Để bắt đầu, bạn có thể **folk** nhánh **beta** của repo này về tài khoản của mình, sửa đổi mã nguồn và tạo **pull request** để yêu cầu cập nhật mã nguồn. Sau khi kiểm tra các thay đổi và phê duyệt, mã nguồn do bạn đóng góp sẽ được gộp vào vnstock.
- Lưu ý: Những thay đổi do bạn đóng góp sẽ được phát hành trong phiên bản tiếp theo của **vnstock** trên Pypi.org đồng thời với những cập nhật của tác giả trên nhánh **beta**.
1. **Folk** nhánh **beta** của repo này về tài khoản của mình, sửa đổi mã nguồn và tạo **pull request** để yêu cầu cập nhật mã nguồn. Sau khi kiểm tra các thay đổi và phê duyệt, mã nguồn do bạn đóng góp sẽ được gộp vào vnstock.
2. Tạo **Pull Request** (PR) để gửi những thay đổi về mã nguồn của bạn tới nhánh `beta` để yêu cầu duyệt và cập nhật mã nguồn khi công việc hoàn thành. Những thay đổi do bạn đóng góp sẽ được cập nhật trên nhánh `beta` để thử nghiệm, sau đó phát hành chính thức trong phiên bản tiếp theo của **vnstock** trên Pypi.org cùng những cập nhật của tác giả.

## Kênh thông tin trao đổi

> Các trao đổi với tác giả trong việc lập trình và đóng góp mã nguồn cho dự án Vnstock, bạn vui lòng sử dụng một trong các tùy chọn sau.

1. Kênh [🧰nhóm-phát-triển](https://discord.com/channels/1096588264254738482/1133760970850832414) trên Discord. Nếu bạn chưa tham gia Discord của Vnstock, hãy tham gia [tại đây](https://discord.gg/6uMq5wZhY4). Trao đổi qua tin nhắn giúp thúc đẩy nhanh quá trình triển khai và xử lý các vấn đề phát sinh nhanh chóng.
2. Mục [Discussion](https://github.com/thinh-vu/vnstock/discussions) có sẵn trên trang Github của dự án. Bạn có thể tạo chủ đề mới hoặc tham gia các chủ đề đã có để trao đổi các ý kiến của mình.

## Tinh thần hợp tác

Tôi hướng đến một môi trường trao đổi thân thiện, tích cực và thúc đẩy hợp tác khi mời các bạn tham gia xây dựng vnstock. Để mọi thứ rõ ràng và minh bạch, tôi chia sẻ tới các bạn những nguyên tắc giúp chúng ta hợp tác dễ dàng hơn trong khuôn khổ một dự án mã nguồn mở như sau:

1. **Hạn chế cảm cảm tính khi trao đổi công việc**: Điều này có được dựa trên việc chúng ta hiểu về những nguyên tắc và nhu cầu của nhau để cả đôi bên ít phải đi lòng vòng trao đổi một cách mơ hồ.
2. **Lắng nghe và tôn trọng ý kiến của nhau**: Việc các bạn đóng góp mã nguồn không giống như cơ chế xin - cho mà là cả tôi, bạn và cộng đồng cùng hưởng lợi. Những ý kiến của bạn luôn được tôn trọng, và tác giả cũng cố gắng trao đổi với tư duy cởi mở, hướng đến kết quả tốt nhất có thể cho dự án.

## Tiêu chuẩn đóng góp

### Quy tắc đặt tên và mô tả
- Đặt tên nhánh: **feat/tieu-de-tinh-nang** hoặc **fix/tieu-de-sua-loi**.
- Mô tả Pull Request: Mô tả rõ ràng và ngắn gọn về tính năng mới hoặc lý do sửa lỗi.

### Quy tắc mã nguồn
- Vui lòng tuân thủ [PEP8](https://www.python.org/dev/peps/pep-0008/) cho mã Python.
- Đảm bảo rằng mã nguồn của bạn đã được kiểm tra kiểm thử và không gây ra lỗi khác trong dự án.
- Tham khảo [PEP8](https://www.python.org/dev/peps/pep-0008/) cho Python để tạo ra mã nguồn sạch sẽ, mạch lạc, và thuận tiện nhất trong việc hợp tác phát triển.
- Đảm bảo rằng mã nguồn của bạn đã được kiểm thử kỹ hạn chế không gây ra lỗi khác trong dự án.
- Để lại comment cho các đoạn mã bạn cung cấp giúp các thành viên khác hiểu được logic thiết kế và bắt kịp ý tưởng của bạn tốt hơn.

### Bản quyền và giấy phép
- Bằng cách đóng góp vào dự án Vnstock, bạn đồng ý rằng đóng góp của bạn sẽ được công bố theo giấy phép [MIT License](https://github.com/thinh-vu/vnstock/blob/beta/LICENSE).
## Bản quyền và giấy phép
- Bằng cách đóng góp vào dự án Vnstock, bạn đồng ý rằng đóng góp của bạn sẽ được công bố tự do theo giấy phép [MIT License](https://github.com/thinh-vu/vnstock/blob/beta/LICENSE).
- Vui lòng thêm tên của bạn vào phần "Người đóng góp" trong tệp [CONTRIBUTORS.md](https://github.com/thinh-vu/vnstock/blob/beta/CONTRIBUTORS.md).

Chúng tôi cảm ơn sự đóng góp của bạn cho Vnstock. Nhóm phát triển sẵn lòng hỗ trợ và xem xét mọi đóng góp để nâng cao chất lượng và tính năng của dự án. Hãy cùng nhau tạo nên một công cụ mạnh mẽ hỗ trợ đầu tư chứng khoán Việt Nam! 🚀
16 changes: 16 additions & 0 deletions docs/docs/community/feedback.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Đóng góp ý kiến và phản hồi

## Báo lỗi
Bạn có thể giúp tác giả kiểm tra mục [Issues](https://github.com/thinh-vu/vnstock/issues) trên Github và mục [Báo lỗi](https://discord.com/channels/1096588264254738482/1096806545431462048) trên Discord xem vấn đề của bạn đã được đề cập trước đó chưa trước khi gửi báo lỗi.

Nếu chưa, hãy tạo một issue mới để báo cáo lỗi hoặc yêu cầu tính năng. Vui lòng cung cấp một mô tả chi tiết về vấn đề của bạn, bao gồm các bước để tái tạo vấn đề (nếu có thể) và ảnh chụp mành hình lỗi. Các báo lỗi mơ hồ sẽ không được xem xét.

Nếu bạn không quen với Github, bạn cứ thoải mái chia sẻ lỗi qua các kênh mà bạn thấy thuận tiện nhất và giúp tôi có thể trao đổi thêm để hiểu rõ vấn đề bạn gặp phải.

## Góp ý

> vnstock là một dự án tôi tâm huyết, đầu tư nhiều thời gian để phát triển giúp bản thân và cộng đồng tiếp cận nguồn dữ liệu chứng khoán miễn phí và đáng tin cậy.

Để đảm bảo rằng vnstock phát triển theo hướng đáp ứng nhu cầu của bạn, tôi rất mong nhận được phản hồi từ bạn. Bạn là người dùng quan trọng của vnstock và ý kiến của bạn sẽ giúp chúng tôi xây dựng một kế hoạch phát triển vnstock một cách toàn diện. Bạn hãy dành ra 5 phút để hoàn thành bản khảo sát này. Cảm ơn bạn rất nhiều!

<iframe src="https://docs.google.com/forms/d/e/1FAIpQLSej7ZR8Q2S15yHWmgWWE8eXvyyhUo2sD3aicoeC_c6SJQSV2A/viewform?embedded=true" width="1024" height="800" frameborder="0" marginheight="0" marginwidth="0">Đang tải…</iframe>
Loading
Loading