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

Readme sections in sidebar #535

Closed
wants to merge 7 commits into from
Closed

Readme sections in sidebar #535

wants to merge 7 commits into from

Conversation

jessetan
Copy link
Contributor

This PR makes the README sections appear in the navbar.
It uses an intermediate file to indirectly include the README (toctree does not allow including files that are in a parent directory).
The location of the README remains unchanged (so it renders nicely on GitHub).

A JavaScript redirect is used to send viewers directly to the README page, rather than displaying a page containing only the table of contents.

Fixes #523.

@Blendify
Copy link
Member

Blendify commented Jan 7, 2018

Personally, I do not think the redirect is needed.

Copy link
Member

@Blendify Blendify left a comment

Choose a reason for hiding this comment

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

Remove javascript

@jessetan
Copy link
Contributor Author

@Blendify do you think the landing page needs some more content then? Without the redirect, readers will land on a page with only toctree that they need to click through.

@Blendify
Copy link
Member

Blendify commented Jan 10, 2018 via email

@Blendify
Copy link
Member

Poke, I would just include an introductory statement in the index this should be adequate to describe the project.

@jessetan
Copy link
Contributor Author

I'm waiting to see what the outcome of #532 is, since it may affect the way we can get the README to show up in the sidebar.

This was referenced Jan 25, 2018
@Blendify
Copy link
Member

The is obsolete now with 67bb54d

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

Successfully merging this pull request may close these issues.

3 participants