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

Improve global documentation generation and layout #27

Open
bmpvieira opened this Issue Apr 4, 2015 · 5 comments

Comments

3 participants
@bmpvieira
Member

bmpvieira commented Apr 4, 2015

The global docs at doc.bionode.io result from the concatenation of all the docco generated html files of each module (e.g., bionode-ncbi docs). We should improve the layout to aim at something similar to the underscore documentation while still keeping it automatic.

@bmpvieira

This comment has been minimized.

Member

bmpvieira commented Apr 20, 2017

I really like literate coding with docco that automatically generate docs from code comments, but maybe we should switch to a more user friendly docs with Slate.

@thejmazz

This comment has been minimized.

Member

thejmazz commented Apr 20, 2017

I also like the docs alongside code, but it makes it more difficult to quickly scan.

Looks like slate might be more for REST API documentation?

For bionode-quickgo I used jsdoc2md. I think if we use jsdoc there are many options available for generated html/markdown from that.

@Wandalen

This comment has been minimized.

Wandalen commented Apr 20, 2017

Docs which should be in code and docs which should be outside of code always present in any project.
Combined approach would be the best. In my opinion.

@bmpvieira

This comment has been minimized.

Member

bmpvieira commented Apr 25, 2017

Hey, check the new (WIP) documentation at http://doc.bionode.io
The repo is bionode/doc.bionode.io and you can just edit the index.html.md file and PR.

@Wandalen

This comment has been minimized.

Wandalen commented Apr 25, 2017

Looks cool :)

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