Skip to content

Possible improvements to the website and documentation #877

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

Closed
3 tasks done
ammarahm-ed opened this issue Jun 1, 2022 · 2 comments
Closed
3 tasks done

Possible improvements to the website and documentation #877

ammarahm-ed opened this issue Jun 1, 2022 · 2 comments

Comments

@ammarahm-ed
Copy link

ammarahm-ed commented Jun 1, 2022

New Feature / Enhancement Checklist

Current Limitation

After a lot of research and using Parse Server in one of my projects after deciding that it is the best solution currently after playing around with other such newer projects such as appwrite, supabase etc I am here with not a feature request but a very important enhancement that could present to people how great parse actually is.

Feature / Enhancement Description

The current website design + documentation is outdated. At a glance most people just tend to assume parse is outdated or too old to be used unless they read the documentation and go through different features to actually realize how good it is. I know parse is fully open-source and doing everything here required a lot of effort from community. But i believe that if the main contributors of parse come along to upgrade the website and docs, a lot of help from the community will pour in including myself.

Example Use Case

In open source, better documentation = marketing. And I mean the docs are written great. But the UI could be much more better and user friendly.

Alternatives / Workarounds

After trying out appwrite, supabase, kuzzel and others, I finally ended up with Parse. If you ask me why initially i didn't choose parse, well. The website and documentation were not clear enough at a glance and user friendly to make me feel that Parse was exactly what I was looking for. So after writing a full core with appwrite and realizing the limitations with database I went again to do some research again and go through parse documentation to look for features and things I needed to decide that parse was the way to go.

3rd Party References

Supabase, Appwrite and Kuzzel and other such services have made their websites and documentation more flashier even though the lack many features that parse already has.

@parse-github-assistant
Copy link

parse-github-assistant bot commented Jun 1, 2022

Thanks for opening this issue!

  • 🎉 We are excited about your ideas for improvement!

@mtrezza
Copy link
Member

mtrezza commented Jun 1, 2022

And I mean the docs are written great. But the UI could be much more better and user friendly.

Improving the docs is an effort on multiple fronts, involving content, structure, consolidation and UI. There is also a lot of documentation in the GitHub README's, which should actually go into the docs. There have been discussions and initiatives in many places, but it never got to a point where there was enough momentum to pick it up - also because it requires quite some effort. The website redesign is also a task we have on our agenda internally. One such discussion can be found in the forum: https://community.parseplatform.org/t/new-documentation/1978

So instead, we ended up focusing on individual initiatives, for example: parse-community/parse-server#8017.

I'm closing this for now, unless you want to use this issue to establish a roadmap and pick up some tasks.

@mtrezza mtrezza closed this as completed Jun 1, 2022
@mtrezza mtrezza transferred this issue from parse-community/parse-server Jun 1, 2022
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

No branches or pull requests

2 participants