openHospitality.network icon indicating copy to clipboard operation
openHospitality.network copied to clipboard

Current project description does not gives good overview of the project

Open mariha opened this issue 4 years ago • 2 comments

Edit this issue to add anything.

For who is this page?

  • general audience looking for an overview of the project
  • potential future contributors to the project
  • us, the team behind, as a central point of reference and navigation to sub-domains.
  • ...

What do we don't like about it?

  • it is too long
  • it may go too deep into technical details
  • it does not reads smoothly, especially for non-techies
  • would be nice to have a one-liner that summarizes what this project is about (mission statement)
  • ...

What do we like about it?

  • it's layout and color scheme is clean and simple
  • it gives a sense that this is a technical project, what we are doing here
  • ...

mariha avatar Jul 09 '21 12:07 mariha

Feedback from @aschrijver from #12: My general impression was the text was too long, and did not provide the gist at the top in a well-structured manner. Plus too technical, too quick.

And a PR which we ended up not merging but which has some very good pieces of text that could potentially be used #14

mariha avatar Jul 09 '21 13:07 mariha

BookWyrm has nice description of federation for people who are not that much into decentralization and fediverse... Might be interesting for us to inspire with it?

https://joinbookwyrm.com/instances/

Join BookWyrm A Network of Small, Self-Directed Communities

Instead of one huge BookWyrm site, there are many instances of BookWyrm which can interact seamlessly with one another. You can have the benefits of small community you trust, while still interacting with a large network of interesting new people (when you want to).

This means there isn't just one place to sign up! You can select an instance that sounds like a good fit for your interests, or just try one at random — they're all very nice.

mariha avatar Dec 10 '21 18:12 mariha