search

sciencefair-land / sciencefair

The futuristic, fabulous and free desktop app for working with scientific literature :microscope: :book:
https://sciencefair-app.com
MIT License
603 stars 52 forks source link

[req] Add User Docs #103

Open VickyRampin opened 7 years ago

VickyRampin commented 7 years ago

I think it would be great if you added a "getting started" guide and as sciencefair evolves, lengthy documentation for users -- although probably you'd want both. I feel like it would benefit users to see a narrative of how to start. Even just a few sentences well publicized on the websites in the spirit of this:

When you download sciencefair, you'll be able to search XYZ corpus of text, download articles (in bulk!), and read and tag them. Here's how that looks!

Followed by a bit of text and images from screenshots in this repo.

In this version it might not be the most necessary (but would be a good addition, in my view), but should definitely add it for version 1.1.

blahah commented 7 years ago

Thanks @VickySteeves - I agree. Do you think this could be served by something as simple as a walkthrough gif? Or do you think we need something more explicit that people can use at their own pace?

VickyRampin commented 7 years ago

I think letting users go at their own pace with gifs is good :wink: but in all seriousness, right now just a short paragraph and a gif/your screenshots would do!

I forked the repo and am working on it.

blahah commented 7 years ago

@VickySteeves shout if I can help point you in the right direction. We also have a chat room if you have any questions. I'm saying this because I'm acutely aware that the site setup is not friendly for new contributors and I would be amazed if anyone can just jump in and contribute to it without any docs!

VickyRampin commented 7 years ago

The hardest part honestly is making the gifs! This is what I have so far:

screenshot from 2017-06-29 15-57-21

I'm going to add some text either below or above those images (gifs), fix the text under the large heading and make a PR!

blahah commented 7 years ago

Whoa, this is spectacularly awesome @VickySteeves!! Thank you so much 😃

Let me know if I can do anything to help, but that looks like a really excellent addition (i tried making gifs a bunch of times and could never get it right)!

VickyRampin commented 7 years ago

Ok, the gifs are kinda big but everything is functional/done -- making my PR!

blahah commented 7 years ago

@VickySteeves to reduce gif size you can upload to giphy then download smaller size which they autoconvert :)