Sorry I didn't get to chime in on this until now (I was actually the one the spoke to Felix about it on IRC in the first place). I don't care too much about the sentences, but I wanted to note that I think an even better solution would be reorganize our docs front page to be like the Python docs front page (see http://docs.python.org/), i.e., have little subheaders for each header.
Aaron Meurer On Oct 21, 2010, at 2:59 AM, Tim Varkalis wrote: > On Wed, Oct 20, 2010 at 6:27 PM, Felix Kaiser <[email protected]> wrote: > If you put it that way it makes sense. > > I've updated the pull request accordingly. > > I have not changed "central" to "primary" as you suggested because that would > contradict "all of". > > Now all the commit does is fix spelling mistakes and add the missing "of", so > it should be ok to push this in. > > Felix > > > Seems fine to me, also seems most people don't really have an opinion! Except > that the spelling mistakes should definitely be corrected ;-) > > Good work :) > > Tim > > > > > > On 10/20/2010 06:42 PM, Tim Varkalis wrote: >> Although it's self-evident that you start with the tutorial if you are new >> to sympy, just saying "the tutorial is here" doesn't seem so friendly. >> >> Also, I would like to know where the main contact point for finding >> documentation is, I also like the idea of (at least trying) to collect it >> all to one site. I think quality, easy to find, accessible documentation is >> the key to getting people to use and enjoy a library (in fact, most software >> in general). My only suggestion would be to change the word 'central' to >> 'principle' or 'primary'. Also, it's technically the central 'site' not >> 'page' but I think it reads fine and doesn't really need changing. >> >> Thinking another way, it achieves the goal of addressing newbies and >> pointing them to the best starting point (how do they know that tutorial >> link is the best starting point? They may be looking for 'introduction to' >> or 'primer' ... who knows?!). Since it achieves this, what is the benefit >> of removing it? >> >> On Wed, Oct 20, 2010 at 5:26 PM, Ondrej Certik <[email protected]> wrote: >> On Wed, Oct 20, 2010 at 8:58 AM, Felix Kaiser <[email protected]> wrote: >> > Hi everyone, >> > >> > right now docs.sympy.org says: >> >> >> >> SymPy is a Python library for symbolic mathematics. If you are new to >> >> SymPy, start with the Tutorial. >> >> >> >> This is the central page for all SymPy’s documentation. >> > >> > The last sentence is missing an "of", which is what got me looking into >> > this. >> > >> > I then decided to remove both that sentence and the previous one ("If you >> > are new to SymPy..."), because both are fairly self-evident. Also the last >> > one doesn't account for wiki and docstrings. Here's the pull request: >> > http://github.com/sympy/sympy/pull/13 (note: the commit also fixes a few >> > more spelling mistakes on that page) >> > >> > Ondrej would like to keep both sentences, while Asmeurer voted for removing >> > them. I am not really sure, but I think we should remove them. >> > >> > So we need more opinions on this. Anyone? >> >> My original idea was to keep those, so that the new user knows that >> this is the only documentation, and also that it forces us to really >> put all the docs in there. >> >> However, if more people think it should be removed, let's remove it. >> >> Ondrej >> >> -- >> You received this message because you are subscribed to the Google Groups >> "sympy" group. >> To post to this group, send email to [email protected]. >> To unsubscribe from this group, send email to >> [email protected]. >> For more options, visit this group at >> http://groups.google.com/group/sympy?hl=en. >> >> >> -- >> You received this message because you are subscribed to the Google Groups >> "sympy" group. >> To post to this group, send email to [email protected]. >> To unsubscribe from this group, send email to >> [email protected]. >> For more options, visit this group at >> http://groups.google.com/group/sympy?hl=en. > > > -- > You received this message because you are subscribed to the Google Groups > "sympy" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]. > For more options, visit this group at > http://groups.google.com/group/sympy?hl=en. > > > -- > You received this message because you are subscribed to the Google Groups > "sympy" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]. > For more options, visit this group at > http://groups.google.com/group/sympy?hl=en. -- You received this message because you are subscribed to the Google Groups "sympy" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/sympy?hl=en.
