Document markers.default_environment()

[brettcannon]

packaging/packaging/markers.py

Lines 257 to 272 in 171e4fb

	def default_environment() -> Dict[str, str]:
	iver = format_full_version(sys.implementation.version)
	implementation_name = sys.implementation.name
	return {
	"implementation_name": implementation_name,
	"implementation_version": iver,
	"os_name": os.name,
	"platform_machine": platform.machine(),
	"platform_release": platform.release(),
	"platform_system": platform.system(),
	"platform_version": platform.version(),
	"python_full_version": platform.python_version(),
	"platform_python_implementation": platform.python_implementation(),
	"python_version": ".".join(platform.python_version_tuple()[:2]),
	"sys_platform": sys.platform,
	}

The name and its inclusion in __all__ suggest this is part of the API and should be documented.

[brettcannon]

@pradyunsg there's now a PR for this at #753 . Are you okay with making this part of the documented, public API?

[pradyunsg]

Yes.