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

DOC: Reference handbook documentation in add_readme #4991

Merged
merged 1 commit into from Oct 7, 2020

Conversation

adswa
Copy link
Member

@adswa adswa commented Oct 7, 2020

I saw that hirni uses add_readme.py to populate studydatasets with a placeholder README (within cfg_hirni). This change makes the README reference the handbook as documentation instead of docs.datalad.org.

Copy link
Member

@yarikoptic yarikoptic left a comment

Choose a reason for hiding this comment

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

surprise surprise -- tests fail for a "legit" reason:

======================================================================
FAIL: datalad.plugin.tests.test_plugins.test_add_readme
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/home/travis/virtualenv/python3.7.1/lib/python3.7/site-packages/nose/case.py", line 198, in runTest
    self.test(*self.arg)
  File "/home/travis/virtualenv/python3.7.1/lib/python3.7/site-packages/datalad/tests/utils.py", line 554, in _wrap_with_tree
    return t(*(arg + (d,)), **kw)
  File "/home/travis/virtualenv/python3.7.1/lib/python3.7/site-packages/datalad/plugin/tests/test_plugins.py", line 241, in test_add_readme
    id=ds.id))
AssertionError: '# Dataset "demo_ds"\n\nthis is for play\n\n### Authors\n\n- Betty\n- Tom\n\n### License\n\nPDDL\n\n## General information\n\nThis is a DataLad dataset (id: 94667534-8bbe-41ad-8c53-a712a75734ac).\n\nFor more information on DataLad and on how to work with its datasets,\nsee the DataLad documentation at: http://handbook.datalad.org\n' != '# Dataset "demo_ds"\n\nthis is for play\n\n### Authors\n\n- Betty\n- Tom\n\n### License\n\nPDDL\n\n## General information\n\nThis is a DataLad dataset (id: 94667534-8bbe-41ad-8c53-a712a75734ac).\n\nFor more information on DataLad and on how to work with its datasets,\nsee the DataLad documentation at: http://docs.datalad.org\n'

@adswa
Copy link
Member Author

adswa commented Oct 7, 2020

ha, crap ;-) I thought "I wouldn't need to run the tests for that change" - will adjust the test.

This replaces a link to docs.datalad.org with handbook.datalad.org in the README
placeholder that is created with add_readme.py
The test for the function is adjusted accordingly.
@codecov
Copy link

codecov bot commented Oct 7, 2020

Codecov Report

Merging #4991 into master will increase coverage by 0.06%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master    #4991      +/-   ##
==========================================
+ Coverage   90.03%   90.09%   +0.06%     
==========================================
  Files         292      292              
  Lines       40984    41005      +21     
==========================================
+ Hits        36900    36945      +45     
+ Misses       4084     4060      -24     
Impacted Files Coverage Δ
datalad/plugin/add_readme.py 93.10% <ø> (ø)
datalad/plugin/tests/test_plugins.py 91.00% <ø> (ø)
datalad/downloaders/http.py 81.85% <0.00%> (-2.71%) ⬇️
datalad/downloaders/tests/test_http.py 88.22% <0.00%> (-1.93%) ⬇️
datalad/plugin/wtf.py 83.53% <0.00%> (+0.76%) ⬆️
datalad/downloaders/s3.py 41.53% <0.00%> (+1.02%) ⬆️
datalad/tests/test_s3.py 56.00% <0.00%> (+6.00%) ⬆️
datalad/support/s3.py 39.62% <0.00%> (+15.10%) ⬆️

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 13619fe...047f839. Read the comment docs.

@kyleam kyleam merged commit d9f3c17 into datalad:master Oct 7, 2020
@kyleam
Copy link
Contributor

kyleam commented Oct 7, 2020

Thanks @adswa. The remaining failures are unrelated.

@adswa adswa deleted the doc-readme branch December 18, 2020 07:32
@yarikoptic yarikoptic added the documentation Documentation-related issue label Jun 2, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Documentation-related issue
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants