[Biopython-dev] Using markup for the README file on GitHub
Peter Cock
p.j.a.cock at googlemail.com
Wed Jun 6 09:12:03 EDT 2012
On Wed, Jun 6, 2012 at 2:07 PM, Brad Chapman <chapmanb at 50mail.com> wrote:
>
> Hi all;
> Matt -- awesome, thanks for looking at this. I'm agreed the GitHub
> presence needs a bit of a lift.
>
> Peter -- do you think the tradeoff of extra files and symlinks and all
> that is worth it for the possibility of confusing a small number of
> people on Windows? My preference would be to have a cleaner
> web presence on GitHub, which will effect more users. If
> README.md is too terse or confusing, we could do
> README.markdown.
Bow's suggestion to exclude the symlink via the manifest solves this
conflict pretty well :)
> In terms of reStructuredText versus Markdown, I don't have a strong
> opinion. I get the sense GitHub better supports Markdown but as long as
> the rst looks fine it doesn't matter.
>
> Brad
Anyone fancy trying an rst version quickly for comparison?
Peter
More information about the Biopython-dev
mailing list