Built-in methods/classes/functions lack documentation. · Issue #2680 · RustPython/RustPython · GitHub
Skip to content

Built-in methods/classes/functions lack documentation. #2680

Description

@DimitrisJim

Most (?) of the built in functionality currently lacks corresponding documentation. The functionality to grab and attach the docs is there, the docs just haven't been added.

This, I believe, could make a good first issue for many people, it just involves taking the documentation and adding it before (after works too but most current examples add it before) the #[py(function/method/class)] attribute. As an example, for list.append one could just add:

/// Append object to the end of the list.
#[pymethod]
pub(crate) fn append(&self, x: PyObjectRef) { ... }

The main built-in classes seem to have documentation for the classes but not for the methods. Builtin modules, I'd assume, probably also have many more cases.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions