]> git.openstreetmap.org Git - osqa.git/blobdiff - forum/settings/faq.py
Adds the option to create static pages with several options to customize its behaviour.
[osqa.git] / forum / settings / faq.py
index a5daa56e80a22b8145035f8be5a1761fd17e895b..2be4a1334a0291f8ded66281fe8d55e597a52fe3 100644 (file)
@@ -4,8 +4,57 @@ from django.forms.widgets import Textarea
 FAQ_SET = SettingSet('faq', 'FAQ page', "Define the text in the about page. You can use markdown and some basic html tags.", 2000, True)
 
 FAQ_PAGE_TEXT = Setting('FAQ_PAGE_TEXT',
-"""
+u"""
+**Please customize this text in the administration area**
 
+**Frequently Asked Questions (FAQ)**
+
+**What kinds of questions can I ask here?**
+
+Most importantly - questions should be relevant to this community. Before you ask - please make sure to search for a similar question. You can search questions by their title or tags.
+
+**What kinds of questions should be avoided?**
+
+Please avoid asking questions that are not relevant to this community, too subjective and argumentative.
+
+**What should I avoid in my answers?**
+
+OSQA: Open Source Q&A Forum is a question and answer site - it is not a discussion group. Please avoid holding debates in your answers as they tend to dilute the essense of questions and answers. For the brief discussions please use commenting facility.
+
+**Who moderates this community?**
+
+The short answer is: you. This website is moderated by the users. Karma system allows users to earn rights to perform a variety of moderation tasks
+
+**How does the karma system work?**
+
+When a question or answer is upvoted, the user who posted them will gain some points, which are called "karma points". These points serve as a rough measure of the community trust to him/her. Various moderation tasks are gradually assigned to the users based on those points.
+
+For example, if you ask an interesting question or give a helpful answer, your input will be upvoted. On the other hand if the answer is misleading - it will be downvoted. Each vote in favor will generate |REP_GAIN_BY_UPVOTED| points, each vote against will subtract |REP_LOST_BY_DOWNVOTED| points. There is a limit of 200 points that can be accumulated per question or answer. The table below explains karma requirements for each type of moderation task.
+
+* add comments ->  |REP_TO_COMMENT|
+* delete comments -> |REP_TO_DELETE_COMMENTS|
+* close own questions -> |REP_TO_CLOSE_OWN|
+* reopen own questions -> |REP_TO_REOPEN_OWN|
+* retag questions -> |REP_TO_RETAG|
+* edit any answer -> |REP_TO_EDIT_OTHERS|
+* open any closed question -> |REP_TO_CLOSE_OTHERS|
+* delete any comment -> |REP_TO_DELETE_COMMENTS|
+
+**What is gravatar?**
+
+Gravatar means globally recognized avatar - your unique avatar image associated with your email address. It's simply a picture that shows next to your posts on the websites that support gravatar protocol. By default gravar appears as a square filled with a snowflake-like figure. You can set your image at gravatar.com
+
+**To register, do I need to create new password?**
+
+No, you don't have to. You can login through any service that supports OpenID, e.g. Google, Yahoo, AOL, etc. Login now!
+
+**Why can other people can edit my questions/answers?**
+
+Goal of this site is... So questions and answers can be edited like wiki pages by experienced users of this site and this improves the overall quality of the knowledge base content. If this approach is not for you, we respect your choice.
+
+**Still have questions?**
+
+Please ask your question, help make our community better!
 """, FAQ_SET, dict(
 label = "FAQ page text",
 help_text = " The faq page. ",