rendering README.ipynb in a project entrypoint page

[parmentelat]

Hi folks

I just created a project whose README is not in markdown, but a notebook instead
https://github.com/parmentelat/asynciojobs/blob/master/README.ipynb

The thing is that when I point at the project’s entry point here
https://github.com/parmentelat/asynciojobs
then the notebook is not rendered, but instead displayed as a raw json file, which kind of ruins the whole notion of a friendly entry point ;)

Is it a fair assumption that this is a bug ?
Or is there just something I should have done to get this to behave as expected (i.e. that the project entry URL renders the notebook)

Would be a great addition IMHO :-)

PS. I have initially sent this request to the github support, who redirected me here

EDIT august 2019:
the project that I pointed out as an illustration is no longer valid, as I changed the repo layout to get this to work as expected, but the gist of my initial comment is stil valid

[pletnes]

Supported, this struck me, too. We use README.md as a format for documentation, but would much, much prefer to use notebooks as they are much richer and easier to create for non-programmers, too!

[Kreijstal]

hmm interesting

[riedel]

There is a (non-)working example in isaacs/github#1425 .

To me it seems really seems more like a bug, than a missing feature...

[asher-pembroke]

This issue can be avoided by keeping the README in markdown and using the jupytext extension. Jupytext allows you to edit markdown and python in jupyter as if they were notebooks.

mwouts/jupytext#527

[github-actions]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[riedel]

To me it seems really seems more like a bug, than a missing feature...

Looking at https://github.com/monperrus/notebooks/ this still is not fixed. Either Readme.ipynb should be not shown or correctly. So this seems really like a longstanding bug.

Just commenting to keep it alive.

[github-actions]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[s-m-e]

Ping.