socioboard / socioboard-core

This is an old repo, for latest maintained version go here - https://github.com/socioboard/Socioboard-Core-3.0
http://www.socioboard.org
238 stars 120 forks source link

Improve documentation for using and installing #37

Open jwflory opened 8 years ago

jwflory commented 8 years ago

Hello!

Problem

Right now, there is not a whole lot of documentation or information for anyone who finds the project and wishes to use it. It's unclear whether there is a web platform a user could try out before setting it up, or if they have to install the server component themselves.

Analysis

Whether it's placed in the README ( #36 ) or in its own wiki page, having this information somewhere would be useful and helpful for bringing in more users to your project and helping them use your software, find bugs, etc.

In 1997, Richard Stallman wrote:

“The biggest deficiency in free operating systems is not in the software —
it is the lack of good free manuals that we can include in these systems.”

Something to consider. :)

Solution

There are a few ways you could tackle having helpful and useful documentation instructions.

EroticD commented 7 years ago

This project really needs this.

socioboard commented 7 years ago

The updated docs are here - wiki.socioboard.com , let us know if they are good enough for you to download/install/use.