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

Start to work on concrete examples of warnings or error messages in help section #418

Merged
merged 8 commits into from
Mar 21, 2020

Conversation

adswa
Copy link
Contributor

@adswa adswa commented Mar 17, 2020

This attempts to collect, explain, and show strategies to solve common errors or warnings. It will forever be work in progress, so just as with FAQ, I'm happy to merge the developments in this branch whenever something useful gets added.

Copy link
Collaborator

@mih mih left a comment

Choose a reason for hiding this comment

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

LGTM. Left a bunch of comments. But they apply more to the software itself than to the documentation in here.


One warning that you may encounter during an installation of a dataset is::

[INFO ] Submodule HEAD got detached. Resetting branch master to point to 046713bb. Original location was 47e53498
Copy link
Collaborator

Choose a reason for hiding this comment

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

We should think about how we can phrase this in a less problematic fashion.

this means that the sibling contains changes that your local dataset does not yet
know about. It can be fixed by updating from the sibling first with a
:command:`datalad update --merge`.

Copy link
Collaborator

Choose a reason for hiding this comment

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

We could try to make the summary result renderer of ˋpushˋ give this hint.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good idea!

@adswa adswa merged commit 4cd93f9 into master Mar 21, 2020
@adswa adswa deleted the help branch March 21, 2020 16:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants