Skip to content

DOC: Document return type from concat #17953

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Oct 26, 2017

Conversation

TomAugspurger
Copy link
Contributor

For a single Series with axis=1.

Closes #17952

@@ -66,6 +66,9 @@ def concat(objs, axis=0, join='outer', join_axes=None, ignore_index=False,
Returns
-------
concatenated : object, type of objs
When concatenating all ``Series`` along the index, a ``Series`` is
returned. When ``objs`` includes at least one ``DataFrame`` or when
concatenating along the columns, a ``DataFrame`` is returned.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would maybe make the "concatenating along the columns" a separate case (so new sentence). Like "Concatenating along the columns (axis=1) always results in a DataFrame"

@codecov
Copy link

codecov bot commented Oct 23, 2017

Codecov Report

Merging #17953 into master will decrease coverage by 0.01%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master   #17953      +/-   ##
==========================================
- Coverage   91.23%   91.22%   -0.02%     
==========================================
  Files         163      163              
  Lines       50113    50113              
==========================================
- Hits        45723    45714       -9     
- Misses       4390     4399       +9
Flag Coverage Δ
#multiple 89.03% <ø> (ø) ⬆️
#single 40.31% <ø> (-0.06%) ⬇️
Impacted Files Coverage Δ
pandas/core/reshape/concat.py 97.58% <ø> (ø) ⬆️
pandas/io/gbq.py 25% <0%> (-58.34%) ⬇️
pandas/core/frame.py 97.75% <0%> (-0.1%) ⬇️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update e1dabf3...00e3d1d. Read the comment docs.

@jreback jreback added this to the 0.21.0 milestone Oct 23, 2017
@jreback
Copy link
Contributor

jreback commented Oct 23, 2017

lgtm. you might want to also update merge.rst (it shows the doc-string there as well)

@TomAugspurger TomAugspurger merged commit 6a94518 into pandas-dev:master Oct 26, 2017
@TomAugspurger TomAugspurger deleted the concat-doc branch October 26, 2017 17:50
peterpanmj pushed a commit to peterpanmj/pandas that referenced this pull request Oct 31, 2017
* DOC: Document return type from concat

For a single Series.

Closes pandas-dev#17952

* Reword
No-Stream pushed a commit to No-Stream/pandas that referenced this pull request Nov 28, 2017
* DOC: Document return type from concat

For a single Series.

Closes pandas-dev#17952

* Reword
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants