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
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]
<mailto:[email protected]>> wrote:
On Wed, Oct 20, 2010 at 8:58 AM, Felix Kaiser
<[email protected] <mailto:[email protected]>> wrote:
> Hi everyone,
>
> right now docs.sympy.org <http://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]
<mailto:[email protected]>.
To unsubscribe from this group, send email to
[email protected]
<mailto: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].
For more options, visit this group at
http://groups.google.com/group/sympy?hl=en.
