<h4 dir="auto">Code Sample, a copy-pastable example if possible</h4>
<p dir="auto"><a href="https://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.is_copy.html#pandas.DataFrame.is_copy" rel="nofollow">https://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.is_copy.html#pandas.DataFrame.is_copy</a></p>
<h4 dir="auto">Problem description</h4>
<p dir="auto">It isn't clear what this property tells -- there's no documentation. When does it become true, and when does it become false?</p>
<h4 dir="auto">Expected Output</h4>
<h4 dir="auto">Output of <code class="notranslate">pd.show_versions()</code></h4>
<h4 dir="auto">Code Sample, a copy-pastable example if possible</h4>
<h4 dir="auto">Problem description</h4>
<p dir="auto">I find the behavior of <code class="notranslate">SettingWithCopyWarning</code> quite surprising, but I guess that's just what it is.<br>
It would be great if you could document <code class="notranslate">is_copy</code> and how to use it, though.</p>
<p dir="auto">Whenever any function returns a dataframe, it seems like it should make sure that <code class="notranslate">is_copy</code> is set to <code class="notranslate">False</code> (or <code class="notranslate">None</code>?) so the user doesn't get a warning if they change it - if you're returning a dataframe, it's unlikely that the user expects this to be a view, and you're not doing chained assignments.</p>
<p dir="auto">The <code class="notranslate">is_copy</code> attribute has an empty docstring in the docs and I couldn't find any explanation of it on the website (via google). The only think that told me that overwriting this attribute is actually the right thing to do (again, which is pretty weird to me), was <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="26013727" data-permission-text="Title is private" data-url="https://github.com/pandas-dev/pandas/issues/6025" data-hovercard-type="issue" data-hovercard-url="/pandas-dev/pandas/issues/6025/hovercard?comment_id=32904245&amp;comment_type=issue_comment" href="https://github.com/pandas-dev/pandas/issues/6025#issuecomment-32904245">#6025 (comment)</a></p>