Skip to content

Commit ad7d6fc

Browse files
iuliakhomenkoTomAugspurger
authored andcommitted
DOC: Update Overview page in documentation (#17368)
* Update Overview page in documentation * DOC Revise Overview page * DOC Make further revisions in Overview webpage * Update overview.rst Remove references to Panel
1 parent 77bfe21 commit ad7d6fc

File tree

1 file changed

+38
-33
lines changed

1 file changed

+38
-33
lines changed

Diff for: doc/source/overview.rst

+38-33
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,11 @@
66
Package overview
77
****************
88

9-
:mod:`pandas` consists of the following things
9+
:mod:`pandas` is an open source, BSD-licensed library providing high-performance,
10+
easy-to-use data structures and data analysis tools for the `Python <https://www.python.org/>`__
11+
programming language.
12+
13+
:mod:`pandas` consists of the following elements
1014

1115
* A set of labeled array data structures, the primary of which are
1216
Series and DataFrame
@@ -21,27 +25,23 @@ Package overview
2125
* Memory-efficient "sparse" versions of the standard data structures for storing
2226
data that is mostly missing or mostly constant (some fixed value)
2327
* Moving window statistics (rolling mean, rolling standard deviation, etc.)
24-
* Static and moving window linear and `panel regression
25-
<http://en.wikipedia.org/wiki/Panel_data>`__
2628

27-
Data structures at a glance
28-
---------------------------
29+
Data Structures
30+
---------------
2931

3032
.. csv-table::
3133
:header: "Dimensions", "Name", "Description"
3234
:widths: 15, 20, 50
3335

34-
1, Series, "1D labeled homogeneously-typed array"
35-
2, DataFrame, "General 2D labeled, size-mutable tabular structure with
36-
potentially heterogeneously-typed columns"
37-
3, Panel, "General 3D labeled, also size-mutable array"
36+
1, "Series", "1D labeled homogeneously-typed array"
37+
2, "DataFrame", "General 2D labeled, size-mutable tabular structure with potentially heterogeneously-typed column"
3838

39-
Why more than 1 data structure?
40-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
39+
Why more than one data structure?
40+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
4141

4242
The best way to think about the pandas data structures is as flexible
4343
containers for lower dimensional data. For example, DataFrame is a container
44-
for Series, and Panel is a container for DataFrame objects. We would like to be
44+
for Series, and Series is a container for scalars. We would like to be
4545
able to insert and remove objects from these containers in a dictionary-like
4646
fashion.
4747

@@ -85,36 +85,41 @@ The first stop for pandas issues and ideas is the `Github Issue Tracker
8585
pandas community experts can answer through `Stack Overflow
8686
<http://stackoverflow.com/questions/tagged/pandas>`__.
8787

88-
Longer discussions occur on the `developer mailing list
89-
<http://groups.google.com/group/pystatsmodels>`__, and commercial support
90-
inquiries for Lambda Foundry should be sent to: [email protected]
88+
Community
89+
---------
9190

92-
Credits
93-
-------
91+
pandas is actively supported today by a community of like-minded individuals around
92+
the world who contribute their valuable time and energy to help make open source
93+
pandas possible. Thanks to `all of our contributors <https://github.com./pandas-dev/pandas/graphs/contributors>`__.
94+
95+
If you're interested in contributing, please
96+
visit `Contributing to pandas webpage <http://pandas.pydata.org/pandas-docs/stable/contributing.html>`__.
9497

95-
pandas development began at `AQR Capital Management <http://www.aqr.com>`__ in
96-
April 2008. It was open-sourced at the end of 2009. AQR continued to provide
97-
resources for development through the end of 2011, and continues to contribute
98-
bug reports today.
98+
pandas is a `NUMFocus <https://www.numfocus.org/open-source-projects/>`__ sponsored project.
99+
This will help ensure the success of development of pandas as a world-class open-source
100+
project, and makes it possible to `donate <https://pandas.pydata.org/donate.html>`__ to the project.
99101

100-
Since January 2012, `Lambda Foundry <http://www.lambdafoundry.com>`__, has
101-
been providing development resources, as well as commercial support,
102-
training, and consulting for pandas.
102+
Project Governance
103+
------------------
103104

104-
pandas is only made possible by a group of people around the world like you
105-
who have contributed new code, bug reports, fixes, comments and ideas. A
106-
complete list can be found `on Github <http://www.github.com./pandas-dev/pandas/contributors>`__.
105+
The governance process that pandas project has used informally since its inception in 2008 is formalized in `Project Governance documents <https://github.com./pandas-dev/pandas-governance>`__ .
106+
The documents clarify how decisions are made and how the various elements of our community interact, including the relationship between open source collaborative development and work that may be funded by for-profit or non-profit entities.
107+
108+
Wes McKinney is the Benevolent Dictator for Life (BDFL).
107109

108110
Development Team
109-
----------------
111+
-----------------
112+
113+
The list of the Core Team members and more detailed information can be found on the `people’s page <https://github.com./pandas-dev/pandas-governance/blob/master/people.md>`__ of the governance repo.
114+
110115

111-
pandas is a part of the PyData project. The PyData Development Team is a
112-
collection of developers focused on the improvement of Python's data
113-
libraries. The core team that coordinates development can be found on `Github
114-
<https://github.com./pydata>`__. If you're interested in contributing, please
115-
visit the `project website <http://pandas.pydata.org>`__.
116+
Institutional Partners
117+
----------------------
118+
119+
The information about current institutional partners can be found on `pandas website page <https://pandas.pydata.org/about.html>`__
116120

117121
License
118122
-------
119123

120124
.. literalinclude:: ../../LICENSE
125+

0 commit comments

Comments
 (0)