Equivalent to df[:n] for non-negative values too

[snoyes]

Equivalent to df[:n] for non-negative values too

[jmarintur]

Hi @snoyes and @rhshadrach, I think the examples are quite self-explanatory, what about changing the first part to something like this:

This function exhibits the same behavior as df[:n], returning the first n rows based on position. It is useful for quickly testing if your object has the right type of data in it.

When n is positive, it returns the first n rows. For n equal to 0, it returns an empty object. For negative values of n, it returns all rows except the last |n| rows, mirroring the behavior of df[:n].

If n is larger...

[rhshadrach]

Thanks for the report. I believe the intention here is to specifically highlight the behavior for negative values, which users might not consider, rather than to suggest this isn't the behavior for positive values.

Do you find this confusing?

[snoyes]

It made me pause to wonder why it was only mentioned in the "negative values" section, worried that implies it does not behave that way for positive values and 0. I think the df[:n] bit should appear in a separate paragraph, so it's clearly true for all n.

[jmarintur]

Hi @rhshadrach, I've created this morning a PR to improve the definition. However, I see there are some unrelated issues that are preventing the branch to pass the checks. Is there anything I can do?