meilisearch/MeiliSearch

Major lack of documentation in codebase

开放

#3,206 创建于 2022年12月7日

 (6 条评论) (2 个反应) (0 位负责人)Rust (2,542 个派生)batch import
contribution accepteddocumentationgood first issue

仓库指标

星标
 (57,572 个星标)
PR 合并指标
 (平均合并 11天 20小时) (30 天内合并 41 个 PR)

描述

Describe the bug The codebase significantly lacks documentation. As a newly introduced developer, it makes it hard for me to navigate the codebase and quickly identify which item does what. The documentation is needed as a source of intuition for evaluating whether some code item is valuable for the end-user, and whether it should be modified, and how exactly it should be modified to accomplish the desired behavior.

Without the said documentation, the codebase can easily become a jungle of functions/structs/enums/traits whose names only suffice for achieving a ballpark of correct understanding rather than the exact understanding required to modify the correct code in the correct way.

Documenting the codebase may constitute a significant upfront investment, but I believe it will pay off in the long run.

To Reproduce Steps to reproduce the behavior: cargo doc --open --document-private-items Alternatively, just look in the code on any arbitrary function/struct/impl/trait/etc. This problem seems to be pervasive throughout most of the codebase.

Expected behavior Each code item (struct, impl, trait, enum, function) should have documentation that explains how the given code item relates to the greater context from the end-user's point of view.

贡献者指南