Ask Your Question

What should the FAQ contain?

asked 2010-08-18 19:55:17 +0200

William Stein gravatar image

updated 2010-12-19 06:54:12 +0200

niles gravatar image

The mathoverflow site has a great FAQ. What are some key points that the FAQ for this site should make?

edit retag flag offensive close merge delete


it might be useful to resurrect this question for a while

niles gravatar imageniles ( 2010-12-19 07:27:13 +0200 )edit

Question? Does the FAQ include any of these things? Doesn't seem to...

kcrisman gravatar imagekcrisman ( 2011-06-01 23:48:51 +0200 )edit

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 gravatar imageniles ( 2011-06-02 01:12:41 +0200 )edit

12 Answers

Sort by ยป oldest newest most voted

answered 2010-08-18 21:11:56 +0200

Before answering the question "What are some key points that the FAQ for this site should make?", we need to know exactly what this site is for. Do we want questions about how to compute things with Sage or other software? Do we want questions about installing and basic usage of Sage? Do we want questions about design, improvement, bugfixes in Sage?

Having a well-defined focus will certainly improve the usefulness of this site. I would like to see the relationship between this and the mailing lists explained/decided.

We might also develop some guidelines about the questions that are asked. It seems like a question such as "Should we support 32-bit FreeBSD?" would not be ideal for this venue; a question such as "I have a bunch of data in format X, how do I load that into Sage, interpret it as Y, and then compute Z?" seems much better.

edit flag offensive delete link more


Having studied the *overflow sites a lot this week, I think this site is most likely to be of value for answering questions like your last example: "I want to do X using Sage. How?" This will help exactly where sage-support often fails, since questions won't get lost here so easily.

William Stein gravatar imageWilliam Stein ( 2010-08-18 21:17:27 +0200 )edit

Also, such questions have a fairly definite answer, and these sites work best with questions that have a definite answer.

William Stein gravatar imageWilliam Stein ( 2010-08-18 21:17:51 +0200 )edit

answered 2010-08-18 20:24:29 +0200

For one, the site should clearly specify its role in providing help for using the Sage software. That is, with the sage-devel and sage-support Google Groups already in place a good question to ask is whether or not this site should in whole or in part provide programming help. Specifying whether or not to focus on user-level or developer-level comments or even both would also help in answering this questions. On a more practical note, the FAQ could provide links to these two sites and state their purpose.

William Stein mentions in his blog post

"The site would not be specific to Sage or restricted to open source."

So another question to ask is "how is distinct from MathOverflow?" since both focus on mathematics. At the very least, my guess is that the topics would focus around "computational mathematics"; that is, anything that could possibly be implemented in Sage. By no means should the site not allow research-level questions. Including them would be great! The FAQ should make clear whatever distinctions are required.

These are just a few questions that popped up in my head when I found out about this neat question board. I'm interested to hear what other people have to say.

edit flag offensive delete link more


My blog remark was really about a site like mathoverflow focused on computation. I don't think is that -- sage is in the name. I also don't think ask.sagemath should be focused on developer questions. It could be: *user question involving sage* -- a better sage-support

William Stein gravatar imageWilliam Stein ( 2010-08-18 21:01:31 +0200 )edit

But it will be good to watch what happens, and decide later just what should be.

William Stein gravatar imageWilliam Stein ( 2010-08-18 21:01:54 +0200 )edit

It would be really interesting if some research discussions involving some computational / Sage elements would spawn on! Once my qualifying exams are over and I resume my work on computing Riemann matrices I hope to contribute some discussions of my own.

cswiercz gravatar imagecswiercz ( 2010-08-19 01:46:08 +0200 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools

1 follower


Asked: 2010-08-18 19:55:17 +0200

Seen: 3,303 times

Last updated: Nov 02 '16