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

Use image URLs instead of relative paths, and add note to CONTRIBUTING.md #163

Merged
merged 5 commits into from Sep 20, 2021

Conversation

ben-xD
Copy link
Contributor

@ben-xD ben-xD commented Sep 1, 2021

When referencing images in markdown files, using a local path such as images/android.png, for example ![An android device running on API level 30](images/android.png) will result in the image missing on pub.dev README preview.

Image not rendering in pub.dev readme

I've suggested an improvement dart-lang/pub-dev#5068, but in the mean time it would be good to fix the images showing on pub.dev

Edit: The reason why this happens is pub.dev converts the image to the master branch URL, e.g. https://github.com/ably/ably-flutter/raw/master/images/run-configuration-1.png, assuming the default branch is master. See dart-lang/pub-dev#5068

Copy link
Member

@owenpearson owenpearson left a comment

Choose a reason for hiding this comment

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

LGTM, although I think we should change back when pub.dev resolves that issue because I assume this will make the images not load if someone tries to preview the markdown locally while offline.

@github-actions github-actions bot temporarily deployed to staging/pull/163/dartdoc September 2, 2021 08:41 Inactive
Copy link
Contributor

@QuintinWillison QuintinWillison left a comment

Choose a reason for hiding this comment

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

Nice. Thanks. 😄

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants