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.
