4 ms·

I think it's mainly a tooling issue—readme files are repo "homepages" by default, there isn't an easy way to inline an image in Markdown (nor should you want to

I think it's mainly a tooling issue—readme files are repo "homepages" by default, there isn't an easy way to inline an image in Markdown (nor should you want to), and people don't want to pollute a repo with binaries.

sixothree 9y ago
This is why I am disappointed GitHub has become the defacto standard. It's not clear what this is or even why this exists. And that seems to be the case with the vast majority of projects on the site.
- jimwalsh 9y ago
  So you want a better readme on most projects?
  - sixothree 9y ago
    I think the readmd is the problem. There is something about the github itself, or the culture around it is the issue, since the problem seems so pervasive. I would prefer the site fosters better project information. Compare github project pages to what you would find at the now defunct codeplex. The difference was night and day.
- mikepurvis 9y ago
  GitHub Pages addresses this exact need, but it requires a small amount of additional work to set up vs. just tossing up a README file.
  - sixothree 9y ago
    I would prefer a site that fosters better care.
KallDrexx 9y ago
Even better, a bunch of my older repositories now have broken images since I had to host the images outside of Github for them to show up in the markdown, so I hosted them on Dropbox. Dropbox has since taken down public hosting of images (or changed the method in which you can do it) so they are all broken (and I"m too lazy/repos are too low traffic for me to bother hunting it all down).
- koolba 9y ago
  I thought you can reference relative pathed images in the same repo.
larrybud 9y ago
Not sure I follow you saying it's not easy to inline images. See: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#images https://github.com/adam-p/markdown-here/wiki/Markdown-Cheats...
- organsnyder 9y ago
  You still have to host the images somewhere—they're not embedded in the document (which is what I meant by "inline"). Not that I think markdown should be able to embed images (that would be contrary to the whole point of the format), but it doesn't lend itself to easy, one-click (or few-keystroke) images.
  - larrybud 9y ago
    Re: "You still have to host the images somewhere—they're not embedded in the document (which is what I meant by "inline")" I still don't follow you; why is this an issue with markdown? Why do you see this as different than any other markup language (e.g, HTML)? Unless we're talking about something like Word documents, you'll have to host the image somewhere, which could be in your github repo. I still don't see why this is an issue.

sixothree 9y ago

This is why I am disappointed GitHub has become the defacto standard. It's not clear what this is or even why this exists. And that seems to be the case with the vast majority of projects on the site.

jimwalsh 9y ago
So you want a better readme on most projects?
- sixothree 9y ago
  I think the readmd is the problem. There is something about the github itself, or the culture around it is the issue, since the problem seems so pervasive. I would prefer the site fosters better project information. Compare github project pages to what you would find at the now defunct codeplex. The difference was night and day.
mikepurvis 9y ago
GitHub Pages addresses this exact need, but it requires a small amount of additional work to set up vs. just tossing up a README file.
- sixothree 9y ago
  I would prefer a site that fosters better care.

KallDrexx 9y ago

Even better, a bunch of my older repositories now have broken images since I had to host the images outside of Github for them to show up in the markdown, so I hosted them on Dropbox. Dropbox has since taken down public hosting of images (or changed the method in which you can do it) so they are all broken (and I"m too lazy/repos are too low traffic for me to bother hunting it all down).

koolba 9y ago
I thought you can reference relative pathed images in the same repo.

larrybud 9y ago

Not sure I follow you saying it's not easy to inline images. See: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#images https://github.com/adam-p/markdown-here/wiki/Markdown-Cheats...

organsnyder 9y ago
You still have to host the images somewhere—they're not embedded in the document (which is what I meant by "inline"). Not that I think markdown should be able to embed images (that would be contrary to the whole point of the format), but it doesn't lend itself to easy, one-click (or few-keystroke) images.
- larrybud 9y ago
  Re: "You still have to host the images somewhere—they're not embedded in the document (which is what I meant by "inline")" I still don't follow you; why is this an issue with markdown? Why do you see this as different than any other markup language (e.g, HTML)? Unless we're talking about something like Word documents, you'll have to host the image somewhere, which could be in your github repo. I still don't see why this is an issue.