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

Dash-style UX / merging doc sources #51

Open
ethchest opened this issue Sep 13, 2018 · 2 comments
Open

Dash-style UX / merging doc sources #51

ethchest opened this issue Sep 13, 2018 · 2 comments

Comments

@ethchest
Copy link

Hi, I was glad to find quickdocs as is it similar especially to dash on the mac and because it had valadoc. However, I would like to ask what the plans are or what direction you want to take it. Specifically, I do not ge why there is such a distinction between valadoc and devdocs.
I know that elementary etc have emphasis on vala, but otherwise I think there is no reason for the distinction, especially considering general UX consideration it doesn't make any sense.
I think ideally the two should be merged. If you want a more prominent place for vala (or other docs of ones choosing) there could instead be an option to set docs in the 'selection bar' (where there now is valadoc and devdocs) or/and in general just improve the UX of the devdocs. If you need some UX inspiration: https://kapeli.com/dash
I am also trying to work with vala so I could also try to work on this if you would consider it.

@mdh34
Copy link
Owner

mdh34 commented Sep 14, 2018

The main reason of the separation is because quickDocs is mainly just a wrapper around the devdocs and valadoc websites with a native interface and a few other things thrown in - at the core it's still just a WebKit browser. The Dash-style UX is really nice and I'm a big fan, but it would need quite a large rework in terms of parsing and presenting the doc sources, as well as things like search etc. which are currently implemented on the website side of things.

@mdh34 mdh34 changed the title Feature/question/issue - which direction does it want to go? Dash-style UX / merging doc sources Sep 14, 2018
@ethchest
Copy link
Author

Mmh, yeah I afterwards found out that devdocs is a separate website. I also discovered dasht - a terminal interface that uses the dash data and has parsing / search afaik. Not sure how feasible this is, but ideally you could use that as a backend, so you (or someone else) would 'just' have to do the gui.

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

2 participants