What should the FAQ contain?

 3 The mathoverflow site has a great FAQ. What are some key points that the FAQ for this ask.sagemath.org site should make? asked Aug 18 '10 William Stein 1195 ● 5 ● 17 ● 40 http://wstein.org/ niles 3354 ● 5 ● 38 ● 92 http://nilesjohnson.net/ it might be useful to resurrect this question for a while niles (Dec 19 '10) Question? Does the FAQ include any of these things? Doesn't seem to... kcrisman (Jun 01 '11) no, I don't know who would update it. Another approach would be to post these as separate question/answer pairs -- I think I'll try that with the syntax question niles (Jun 01 '11)

 1 It should have VERY clear instructions about what people can and cannot do with various 'point levels', and exactly how many 'points' you get for various actions. For example, I just wanted to retag a bunch of questions as 'graphics' since that matches the Trac thing and would make them easy to find... but I can't. There should also be explanations of every color thingie and what the "0 mins ago John Palmieri 36" means (last answer? last comment? what?). Essentially, every possible thing on the front page should be well-documented on the FAQ. To be fair, I just checked out the actual askbot site... and it doesn't do that either! (This is less on topic, but it is also weird that the number of votes and answers on the front page don't correspond to the actual number of votes and answers.) posted Aug 19 '10 kcrisman 6639 ● 13 ● 66 ● 150
 1 A clear statement that this site is for the mathematics software Sage, not the accounting software by the same name. posted Feb 17 '11 niles 3354 ● 5 ● 38 ● 92 http://nilesjohnson.net/ Heh heh. Agreed. cswiercz (Feb 17 '11)
 0 Links to good answers (per rating system) which have a high frequency of tag hits (from the search box) and a high frequency of fulltext-search hits, weighted. Also links to answers with high pagerank (from a google search with site:ask.sagemath.org). posted Aug 19 '10 ccanonc 477 ● 3 ● 15 ● 32
 0 What is this site for? This probably deserves to be its own question, but some discussion has started in the comments here already. I'd like to add that I think/hope certain questions about sage development can be included here (and tagged with devel)--this could be a good resource for those starting out with sage development. For example, the question about mercurial queues could, in its answers, help others get off to a smoother start. posted Aug 19 '10 niles 3354 ● 5 ● 38 ● 92 http://nilesjohnson.net/ Explaining good use of tags, in general, is a good idea. The FAQ could suggest / require that certain topics (like sage development) include tags. It might be helpful to use tags to separate the devel and support communities so it's easier to find relevant posts. cswiercz (Aug 19 '10)
 0 Editing tips. There isn't anything particularly helpful included near the "Your answer" text box (except, of course, the buttons :). If there's an easy way to link to other posts, or to particular pages of the sage documentation, that would be useful information. posted Aug 19 '10 niles 3354 ● 5 ● 38 ● 92 http://nilesjohnson.net/
 0 Recently askbot has been updated to make it easy to link to Trac tickets with the syntax "ticket 1956" as well as autolinking url's like http://sagemath.org. Both of these would make useful additions to the FAQ. Further details are given here (at the askbot site) Moreover, new users often overlook the code formatting button (little picture of 0's and 1's), so perhaps that should be a FAQ item too. posted Dec 19 '10 niles 3354 ● 5 ● 38 ● 92 http://nilesjohnson.net/
 0 Links to other places for getting help: some good intro. to Python tutorials Sage Reference Manual sage-support sage-devel posted Feb 17 '11 niles 3354 ● 5 ● 38 ● 92 http://nilesjohnson.net/
 0 The FAQ should say that this site is for questions about using the software, not about answering homework or other general mathematical questions. Some places to get such help are: Dr. Math Math Stackexchange Ask an Algebraist (for algebra questions) posted Mar 13 '11 niles 3354 ● 5 ● 38 ● 92 http://nilesjohnson.net/

[hide preview]