Skip to content

Re-structured Doc#513

Merged
amcadmus merged 58 commits intodeepmodeling:develfrom
tuoping:devel
May 9, 2021
Merged

Re-structured Doc#513
amcadmus merged 58 commits intodeepmodeling:develfrom
tuoping:devel

Conversation

@tuoping
Copy link
Collaborator

@tuoping tuoping commented Apr 14, 2021

Modified the index structures.

@codecov-io
Copy link

codecov-io commented Apr 14, 2021

Codecov Report

Merging #513 (ba1bc7b) into devel (cb26ef7) will decrease coverage by 0.01%.
The diff coverage is n/a.

❗ Current head ba1bc7b differs from pull request most recent head dfe2193. Consider uploading reports for the commit dfe2193 to get more accurate results
Impacted file tree graph

@@            Coverage Diff             @@
##            devel     #513      +/-   ##
==========================================
- Coverage   60.18%   60.16%   -0.02%     
==========================================
  Files          73       73              
  Lines        6085     6087       +2     
==========================================
  Hits         3662     3662              
- Misses       2423     2425       +2     
Impacted Files Coverage Δ
deepmd/utils/argcheck.py 17.31% <0.00%> (-0.16%) ⬇️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update cb26ef7...dfe2193. Read the comment docs.

@codecov-commenter
Copy link

codecov-commenter commented Apr 19, 2021

Codecov Report

Merging #513 (3735a8f) into devel (0d0cb77) will increase coverage by 0.73%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##            devel     #513      +/-   ##
==========================================
+ Coverage   62.09%   62.82%   +0.73%     
==========================================
  Files          74       75       +1     
  Lines        6229     6333     +104     
==========================================
+ Hits         3868     3979     +111     
+ Misses       2361     2354       -7     
Impacted Files Coverage Δ
deepmd/utils/argcheck.py 16.36% <0.00%> (-0.18%) ⬇️
deepmd/utils/type_embed.py 100.00% <0.00%> (ø)
deepmd/utils/network.py 96.36% <0.00%> (+0.06%) ⬆️
deepmd/model/ener.py 90.72% <0.00%> (+0.39%) ⬆️
deepmd/utils/data.py 90.63% <0.00%> (+0.45%) ⬆️
deepmd/train/trainer.py 38.84% <0.00%> (+0.52%) ⬆️
deepmd/descriptor/se_a.py 90.57% <0.00%> (+1.60%) ⬆️
deepmd/fit/ener.py 93.29% <0.00%> (+7.66%) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 0d0cb77...3735a8f. Read the comment docs.

@tuoping
Copy link
Collaborator Author

tuoping commented Apr 20, 2021

The latest commit changed LICENSE in the main directory to LICENSE.rst and linked it to index.rst.
A new file credits.rst, with all the contributor's GITHUB usernames are listed. Zhang ZiXuan as the designer of logo is listed under "other credits".
Side bar is reconstructed into four sections.
API is modified and recomplied.
Use-DeePMD-kit is renames as getting-started.
Pair-style-deepmd-command is merged into getting-started, under "Run MD with Lammps".
Lammps, i-PI and ASE are incorporated under a same entry "Run MD".
Install.rst is seperated to 2 parts: install_easy.rst and install_source.rst.
All the URLs are updated

Copy link
Contributor

@marian-code marian-code left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you please add my name to the list @tuoping ? I do not want to create new PR just for that.

@njzjz njzjz added this to the v2.0.0 milestone Apr 29, 2021
tuoping added 3 commits April 29, 2021 15:31
including
    "what you can contribute"
    "before you contribute": "overview of deepmd-kit" (branches) and "developer guide" (Link to "doc/development/index")
    "how to contribute": fork, clone, change, unittest, commit and PR

Made directories troubleshooting and development, so that it's easier for everyone to PR.

Added roadmap.md in doc to list optional commissions for future contributors.

Removed highlights in doc, and added in README.

Removed empty file known_issues.md
PS: All the links to repo community are futile yet.
…put-auto.rst (train-input.rst is basically emplty).
@amcadmus amcadmus changed the base branch from devel to api April 30, 2021 10:55
@amcadmus amcadmus changed the base branch from api to devel April 30, 2021 10:55
tuoping and others added 2 commits April 30, 2021 07:02
@tuoping
Copy link
Collaborator Author

tuoping commented May 3, 2021

Added two functions in conf.py to detect files in folders troubleshooting/ and development/, and append them in troubleshooting/index.md and development/index.md automatically.
Sorry, forgot to mention this in COMMIT_MSG.

Co-authored-by: Jinzhe Zeng <jinzhe.zeng@rutgers.edu>
amcadmus added 2 commits May 8, 2021 09:22
Not all contributors are core contributor
@amcadmus amcadmus merged commit 2dfb64a into deepmodeling:devel May 9, 2021
Comment on lines +3 to +4
- [coding-conventions](coding-conventions.rst)
- [api](api.rst)
Copy link
Member

@njzjz njzjz May 9, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These two links use filenames instead of titles?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll change that.

@njzjz njzjz mentioned this pull request May 11, 2021
@njzjz njzjz linked an issue May 11, 2021 that may be closed by this pull request
This was referenced Jun 10, 2021
gzq942560379 pushed a commit to HPC-AI-Team/deepmd-kit that referenced this pull request Sep 1, 2021
* check html window

* change index.rst of branch devel

* Re-structured doc

* Re-structured Doc

* Re-structured Doc

* Re-structured Doc

* Re-structured Doc

* Re-structured Doc

* Re-structured Doc

* Set theme jekyll-theme-cayman

* Create index.md

* Re-structured Doc

* Re-structured Doc

* Re-structured index.rst and seperated install.rst into 3 files;
Renamed use-deepmd-kit as getting-started, and changed the contents a little.

* Same as before

* Edited license.rst and credits.rst

* same as before

* Modified pair-style-deepmd syntax part

* Fixed the collapsed table in getting-started#prepare-data by adding extension sphinx-markdown-tables in conf.py

* Added sphinx-markdown-table in requirements.txt

* Modification after Merge

* modified superlinks in getting-started.md

* same

* Something is imperfect with the url. I can't link to #section in another .md file. So I changed all the external links in getting-started.md, and deleted all the #... parts.

* changed LICENSE to url; deleted whatsnew, application-examples and known_issues in index.rst

* corrected subsection links

* testing external section links

* same

* changed all the superlinks in getting-started.md from markdown format to html format

* same

* Update doc/conf.py

Do not use any <tab> in Python files.

Co-authored-by: Jinzhe Zeng <jinzhe.zeng@rutgers.edu>

* Update doc/getting-started.md

Use a publish version instead

Co-authored-by: Jinzhe Zeng <jinzhe.zeng@rutgers.edu>

* added some descriptor/scripts in api.rst; Changed the user names of contributors in credits.rst; Removed install-hardware-platforms; Put URL for GPLv2 in index.rst

* Changed parser from recommonmark to myst, so the header-anchors in getting-started can support both markdown and html links.

* add myst-parser in requirements

* move doc dependence packages from requirements.txt to setup.py

* changed contributor's order in credits.rst

* change whatsnew

* change highlights in 2.0 in README.md

* Update README.md

Testing README.md

* Add CONTRIBUTING.md
including
    "what you can contribute"
    "before you contribute": "overview of deepmd-kit" (branches) and "developer guide" (Link to "doc/development/index")
    "how to contribute": fork, clone, change, unittest, commit and PR

Made directories troubleshooting and development, so that it's easier for everyone to PR.

Added roadmap.md in doc to list optional commissions for future contributors.

Removed highlights in doc, and added in README.

Removed empty file known_issues.md

* Fixed some minor mistakes.
PS: All the links to repo community are futile yet.

* changed document for training inputs from train-input.rst to train-input-auto.rst (train-input.rst is basically emplty).

* Fixed links under "highlights in kit2.0.0".

* Checked all the links, and made sure they work both in markdown mode and html mode. Especially the ones in README.md and CONTRIBUTING.md

* Sorry, fixed a broken link in CONTRIBUTING.md.

* Asigned language 'bash' for codes in CONTRIBUTING.md; Corrected a typo in README.md

* Update CONTRIBUTING.md

* fix typo in README.md

Co-authored-by: Jinzhe Zeng <jinzhe.zeng@rutgers.edu>

* Update README.md

* Update credits.rst

Not all contributors are core contributor

Co-authored-by: Jinzhe Zeng <jinzhe.zeng@rutgers.edu>
Co-authored-by: tuoping <abby@DESKTOP-LV5KL0D.localdomain>
Co-authored-by: Han Wang <amcadmus@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Citations missing

6 participants