diff --git a/docs/intro/community.rst b/docs/intro/community.rst index 329d86764..c9635c0a0 100644 --- a/docs/intro/community.rst +++ b/docs/intro/community.rst @@ -1,3 +1,5 @@ +.. _the_community: + The Community ============= diff --git a/docs/intro/duction.rst b/docs/intro/duction.rst index 0bd99e755..83b3aa713 100644 --- a/docs/intro/duction.rst +++ b/docs/intro/duction.rst @@ -1,7 +1,56 @@ Introduction ============ -.. todo:: write a general blurb introducing the Python language +From the `official Python website `_: + +Python is a general-purpose, high-level programming language similar +to Tcl, Perl, Ruby, Scheme, or Java. Some of its main key features +include: + +* very clear, readable syntax + + Python's philosophy focuses on readability, from code blocks + delineated with significant whitespace to intuitive keywords in + place of inscrutable punctuation + +* extensive standard libraries and third party modules for virtually + any task + + Python is sometimes described with the words "batteries included" + for its extensive + `stanadard library `_, which can + includes modules for regular expressions, file IO, fraction handling, + object serialization, and much more. + + Additionally, the + `Python Package Index `_ is available + for users to submit their packages for widespread use, similar to + Perl's `CPAN `_. There is a thriving community + of very powerful Python frameworks and tools like + the `Django `_ web framework and the + `NumPy `_ set of math routines. + +* integration with other systems + + Python can integrate with `Java libraries `_, + enabling it to be used with the rich Java environment that corporate + programmers are used to. It can also be + `extended by C or C++ modules `_ + when speed is of the essence. + +* ubiquity on computers + + Python is available on Windows, \*nix, and Mac. It runs wherever the + Java virtual machine runs, and the reference implementation CPython + can help bring Python to wherever there is a working C compiler. + +* friendly community + + Python has a vibrant and large :ref:`community ` + which maintains wikis, conferences, countless repositories, + mailing lists, IRC channels, and so much more. Heck, the Python + community is even helping to write this guide! + .. _about-ref: