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] <sympy%[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] <sympy%[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.
