Skip to content

Commit

Permalink
DOC clean up doc/source/getting_started/overview.rst (pandas-dev#35981)
Browse files Browse the repository at this point in the history
* improved the documentation

* Update doc/source/getting_started/overview.rst

Co-authored-by: Marco Gorelli <m.e.gorelli@gmail.com>

* new commit

* content changed

* new commit

Co-authored-by: Marco Gorelli <m.e.gorelli@gmail.com>
  • Loading branch information
0xpranjal and MarcoGorelli committed Aug 31, 2020
1 parent b8981f4 commit 7254769
Showing 1 changed file with 8 additions and 8 deletions.
16 changes: 8 additions & 8 deletions doc/source/getting_started/overview.rst
Expand Up @@ -9,9 +9,9 @@ Package overview
**pandas** is a `Python <https://www.python.org>`__ package providing fast,
flexible, and expressive data structures designed to make working with
"relational" or "labeled" data both easy and intuitive. It aims to be the
fundamental high-level building block for doing practical, **real world** data
fundamental high-level building block for doing practical, **real-world** data
analysis in Python. Additionally, it has the broader goal of becoming **the
most powerful and flexible open source data analysis / manipulation tool
most powerful and flexible open source data analysis/manipulation tool
available in any language**. It is already well on its way toward this goal.

pandas is well suited for many different kinds of data:
Expand All @@ -21,7 +21,7 @@ pandas is well suited for many different kinds of data:
- Ordered and unordered (not necessarily fixed-frequency) time series data.
- Arbitrary matrix data (homogeneously typed or heterogeneous) with row and
column labels
- Any other form of observational / statistical data sets. The data actually
- Any other form of observational / statistical data sets. The data
need not be labeled at all to be placed into a pandas data structure

The two primary data structures of pandas, :class:`Series` (1-dimensional)
Expand Down Expand Up @@ -57,7 +57,7 @@ Here are just a few of the things that pandas does well:
Excel files, databases, and saving / loading data from the ultrafast **HDF5
format**
- **Time series**-specific functionality: date range generation and frequency
conversion, moving window statistics, date shifting and lagging.
conversion, moving window statistics, date shifting, and lagging.

Many of these principles are here to address the shortcomings frequently
experienced using other languages / scientific research environments. For data
Expand Down Expand Up @@ -101,12 +101,12 @@ fashion.

Also, we would like sensible default behaviors for the common API functions
which take into account the typical orientation of time series and
cross-sectional data sets. When using ndarrays to store 2- and 3-dimensional
cross-sectional data sets. When using the N-dimensional array (ndarrays) to store 2- and 3-dimensional
data, a burden is placed on the user to consider the orientation of the data
set when writing functions; axes are considered more or less equivalent (except
when C- or Fortran-contiguousness matters for performance). In pandas, the axes
are intended to lend more semantic meaning to the data; i.e., for a particular
data set there is likely to be a "right" way to orient the data. The goal,
data set, there is likely to be a "right" way to orient the data. The goal,
then, is to reduce the amount of mental effort required to code up data
transformations in downstream functions.

Expand Down Expand Up @@ -148,8 +148,8 @@ pandas possible. Thanks to `all of our contributors <https://github.com/pandas-d
If you're interested in contributing, please visit the :ref:`contributing guide <contributing>`.

pandas is a `NumFOCUS <https://www.numfocus.org/open-source-projects/>`__ sponsored project.
This will help ensure the success of development of pandas as a world-class open-source
project, and makes it possible to `donate <https://pandas.pydata.org/donate.html>`__ to the project.
This will help ensure the success of the development of pandas as a world-class open-source
project and makes it possible to `donate <https://pandas.pydata.org/donate.html>`__ to the project.

Project governance
------------------
Expand Down

0 comments on commit 7254769

Please sign in to comment.