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

Consider multi page Cog-Book #21

Open
Shelton opened this issue Nov 3, 2016 · 2 comments
Open

Consider multi page Cog-Book #21

Shelton opened this issue Nov 3, 2016 · 2 comments

Comments

@Shelton
Copy link
Collaborator

Shelton commented Nov 3, 2016

See this for reference:
https://github.com/asciidoctor/asciidoctor-extensions-lab/blob/master/lib/multipage-html5-converter.rb

@Shelton
Copy link
Collaborator Author

Shelton commented Dec 16, 2016

I think that breaking it into multiple stand alone pages will help facilitate community feedback via PR submissions for that particular page.

@Shelton
Copy link
Collaborator Author

Shelton commented Dec 16, 2016

Upon further reading/thinking, IF we do move to a broken down Cog-Book model (which reads to be hotly debated and difficult), the user will lose the ability to control-f / command-f search for things. This will leave Cog-Book without a robust search feature. Making these updates seem to be a heavier engineering lift than to just linking the user to that particular file for editing on GitHub. I am going to look into how we can give users at the very least a way of navigating to the .md fit for editing suggestions. That direction seems rather simple - just need to figure out how to present this feature to them per section without it becoming annoying.

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

No branches or pull requests

1 participant