conan-io / conan-io/docs

[bug] Why are some methods documentation not at the top level? (and other oddities)

Open
#1,974 3 comments 0 reactions 0 assignees View on GitHub
Dominant language
C++
Stars
125
Forks
382
Avg merge
22h 39m
Merged PRs (30d)
21

Description

### Steps to reproduce (Include if Applicable)
This might be my relative ignorance of python, but sometimes i'm looking at self.copy and I say "ok those are methods of ConanFile...let me look at the handy conanfile.py Methods reference (which is also weird...why isn't it the documentation for the python class ConanFile?)...but i digress. Instead I need to zoom around and find that it's under the package method. Why not at the top level with package cross referencing it? Similarly with self.run. Again maybe i'm missing something but i've run into this multiple times. Maybe self.copy is somehow dynamically added within package? In that case i guess it would still be nice to show 'copy' as a sub-bullet of 'package' or something since that is maybe a more foreign concept at least to C++ developers.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.