Dataframe.median and Dataframe.mean documentation

[Aamir-Raza]

https://pandas-docs.github.io/pandas-docs-travis/generated/pandas.DataFrame.median.html?highlight=dataframe%20median#pandas.DataFrame.median

DataFrame.median(axis=None, skipna=None, level=None, numeric_only=None, **kwargs)

Issue:

skipna shows as None in the code above but in the parameters it says 'skipna : boolean, default True'. So should it say True in the line above? Maybe I'm wrong, feel free to correct me!

Same for dataframe.mean:
https://pandas-docs.github.io/pandas-docs-travis/generated/pandas.DataFrame.mean.html?highlight=dataframe%20mean#pandas.DataFrame.mean

[jorisvandenbossche]

Thanks for reporting. This is due to the actual code implementation, but I agree we should always try to get it render correctly in the docs.

In this case, I am not fully sure the None in the code is actually needed:

pandas/pandas/core/generic.py

Lines 7903 to 7907 in 8f1dfa7

	def stat_func(self, axis=None, skipna=None, level=None, numeric_only=None,
	**kwargs):
	nv.validate_stat_func(tuple(), kwargs, fname=name)
	if skipna is None:
	skipna = True

@jreback any idea why the default is not just skipna=True. I don't see a reason in this snippet to have the default None and only later set it (it's not that we do something with the fact it being None, like for eg a deprecation).