ASKSAGE: Sage Q&A Forum - Individual question feedhttp://ask.sagemath.org/questions/Q&A Forum for SageenCopyright Sage, 2010. Some rights reserved under creative commons license.Wed, 02 Nov 2016 21:37:46 -0500What should the FAQ contain?http://ask.sagemath.org/question/7570/what-should-the-faq-contain/The [mathoverflow site][1] has [a great FAQ][2]. What are some key points that the FAQ for this ask.sagemath.org site should make?
[1]: http://mathoverflow.net/
[2]: http://mathoverflow.net/faqWed, 18 Aug 2010 12:55:17 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/Comment by niles for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=22384#post-id-22384it might be useful to resurrect this question for a whileSun, 19 Dec 2010 00:27:13 -0600http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=22384#post-id-22384Comment by kcrisman for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=21643#post-id-21643Question? Does the FAQ include any of these things? Doesn't seem to...Wed, 01 Jun 2011 16:48:51 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=21643#post-id-21643Comment by niles for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=21641#post-id-21641no, 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 Wed, 01 Jun 2011 18:12:41 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=21641#post-id-21641Answer by niles for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=12109#post-id-12109Links to other places for getting help:
* some good intro. to Python tutorials
* [Sage Reference Manual](http://www.sagemath.org/doc/reference/index.html)
* [`sage-support`](http://groups.google.com/group/sage-support)
* [`sage-devel`](http://groups.google.com/group/sage-devel)
Thu, 17 Feb 2011 00:24:03 -0600http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=12109#post-id-12109Answer by ccanonc for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11433#post-id-11433Links 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).Thu, 19 Aug 2010 07:01:29 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11433#post-id-11433Answer by kcrisman for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11457#post-id-11457It 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.)Thu, 19 Aug 2010 10:28:53 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11457#post-id-11457Answer by niles for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11877#post-id-11877Recently 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)](http://askbot.org/en/question/215/auto-link-urls-please?answer=251#251)
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.Sun, 19 Dec 2010 00:25:01 -0600http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11877#post-id-11877Comment by kcrisman for <p>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 <a href="http://sagemath.org">http://sagemath.org</a>. Both of these would make useful additions to the FAQ. Further details are given <a href="http://askbot.org/en/question/215/auto-link-urls-please?answer=251#251">here (at the askbot site)</a></p>
<p>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.</p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=35371#post-id-35371I don't think I ever knew about this.Wed, 02 Nov 2016 21:37:46 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=35371#post-id-35371Answer by etb for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=35364#post-id-35364direction for **how to ask *a good question,*** e.g. aim to post a question with code that can reproduce your problem, make it short.Wed, 02 Nov 2016 16:21:59 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=35364#post-id-35364Answer by niles for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11446#post-id-11446What 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][1] could, in its answers, help others get off to a smoother start.
[1]: http://ask.sagemath.org/question/4/why-is-so-hard-to-use-mercurial-queuesThu, 19 Aug 2010 09:39:25 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11446#post-id-11446Comment by cswiercz for <p>What is this site for?</p>
<p>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 <code>devel</code>)--this could be a good resource for those starting out with sage development. For example, the question about <a href="http://ask.sagemath.org/question/4/why-is-so-hard-to-use-mercurial-queues">mercurial queues</a> could, in its answers, help others get off to a smoother start.</p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23046#post-id-23046Explaining 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.Thu, 19 Aug 2010 10:34:06 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23046#post-id-23046Answer by cswiercz for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11373#post-id-11373For 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
<blockquote>
"The site would not be specific to Sage or restricted to open source."
</blockquote>
So another question to ask is "how is ask.sagemath.org 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.Wed, 18 Aug 2010 13:24:29 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11373#post-id-11373Comment by cswiercz for <p>For one, the site should clearly specify its role in providing help for using the Sage software. That is, with the <strong>sage-devel</strong> and <strong>sage-support</strong> 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.</p>
<p>William Stein mentions in his blog post</p>
<blockquote>
"The site would not be specific to Sage or restricted to open source."
</blockquote>
<p>So another question to ask is "how is <a href="http://ask.sagemath.org">ask.sagemath.org</a> 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.</p>
<p>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.</p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23085#post-id-23085It would be really interesting if some research discussions involving some computational / Sage elements would spawn on ask.sagemath.org! Once my qualifying exams are over and I resume my work on computing Riemann matrices I hope to contribute some discussions of my own.Wed, 18 Aug 2010 18:46:08 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23085#post-id-23085Comment by William Stein for <p>For one, the site should clearly specify its role in providing help for using the Sage software. That is, with the <strong>sage-devel</strong> and <strong>sage-support</strong> 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.</p>
<p>William Stein mentions in his blog post</p>
<blockquote>
"The site would not be specific to Sage or restricted to open source."
</blockquote>
<p>So another question to ask is "how is <a href="http://ask.sagemath.org">ask.sagemath.org</a> 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.</p>
<p>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.</p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23100#post-id-23100My blog remark was really about a site like mathoverflow focused on computation. I don't think http://ask.sagemath.org 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-supportWed, 18 Aug 2010 14:01:31 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23100#post-id-23100Comment by William Stein for <p>For one, the site should clearly specify its role in providing help for using the Sage software. That is, with the <strong>sage-devel</strong> and <strong>sage-support</strong> 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.</p>
<p>William Stein mentions in his blog post</p>
<blockquote>
"The site would not be specific to Sage or restricted to open source."
</blockquote>
<p>So another question to ask is "how is <a href="http://ask.sagemath.org">ask.sagemath.org</a> 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.</p>
<p>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.</p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23099#post-id-23099But it will be good to watch what happens, and decide later just what ask.sagemath.org should be.Wed, 18 Aug 2010 14:01:54 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23099#post-id-23099Answer by Bétréma for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=12712#post-id-12712What is the relation of asksage with http://sagemath.blogspot.com/ ? Eg. "Getting started with Cython" was very interesting, but the 'NEXT TIME' announced was never wroten. Of course everybody can understand that William Stein may be overbooked :-) but is it a deliberate strategy to abandon the blog in favor of asksage ?Wed, 05 Oct 2011 07:36:40 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=12712#post-id-12712Comment by niles for <p>What is the relation of asksage with <a href="http://sagemath.blogspot.com/">http://sagemath.blogspot.com/</a> ? Eg. "Getting started with Cython" was very interesting, but the 'NEXT TIME' announced was never wroten. Of course everybody can understand that William Stein may be overbooked :-) but is it a deliberate strategy to abandon the blog in favor of asksage ?</p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=21169#post-id-21169I've never heard of a relationship between asksage and William's blog. If anything, this site is more comparable to the sage-support mailing list, although the two are different enough that they both continue functioning more-or-less independently.Thu, 06 Oct 2011 14:16:42 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=21169#post-id-21169Answer by niles for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=12097#post-id-12097A clear statement that this site is for the *mathematics software* Sage, not the accounting software by the same name.Thu, 17 Feb 2011 00:19:03 -0600http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=12097#post-id-12097Comment by cswiercz for <p>A clear statement that this site is for the <em>mathematics software</em> Sage, not the accounting software by the same name.</p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=22097#post-id-22097Heh heh. Agreed.Thu, 17 Feb 2011 05:49:54 -0600http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=22097#post-id-22097Answer by Dan Drake for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11385#post-id-11385Before answering the question "What are some key points that the FAQ for this ask.sagemath.org 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.
Wed, 18 Aug 2010 14:11:56 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11385#post-id-11385Comment by William Stein for <p>Before answering the question "What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> 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?</p>
<p>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. </p>
<p>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.</p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23097#post-id-23097Having 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.Wed, 18 Aug 2010 14:17:27 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23097#post-id-23097Comment by William Stein for <p>Before answering the question "What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> 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?</p>
<p>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. </p>
<p>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.</p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23096#post-id-23096Also, such questions have a fairly definite answer, and these sites work best with questions that have a definite answer. Wed, 18 Aug 2010 14:17:51 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?comment=23096#post-id-23096Answer by niles for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11447#post-id-11447Editing 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.Thu, 19 Aug 2010 09:45:21 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=11447#post-id-11447Answer by niles for <p>The <a href="http://mathoverflow.net/">mathoverflow site</a> has <a href="http://mathoverflow.net/faq">a great FAQ</a>. What are some key points that the FAQ for this <a href="http://ask.sagemath.org">ask.sagemath.org</a> site should make? </p>
http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=12178#post-id-12178The 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](http://mathforum.org/dr/math/)
* [Math Stackexchange](http://math.stackexchange.com/)
* [Ask an Algebraist](http://at.yorku.ca/cgi-bin/bbqa?forum=ask_an_algebraist;task=list) (for algebra questions)Sun, 13 Mar 2011 03:44:22 -0500http://ask.sagemath.org/question/7570/what-should-the-faq-contain/?answer=12178#post-id-12178