drivendataorg/cloudpathlib

Documentation updates content + style

オープン

#133 opened on 2021/03/13

 (1 件のコメント) (0 件のリアクション) (0 人の担当者)Python (87 件のフォーク)auto 404
documentationgood first issue

Repository metrics

Stars
 (624 個のスター)
PR merge metrics
 (PR metrics pending)

説明

I had a few thoughts while looking at #132 that may be useful for improving our documentation content and styling

Content:

  • "Getting started" page - usually the first page I click on, which should be mostly code and have steps for install, instatiation and simple read/write examples.
  • Examples/cookbook/common use cases (download files, listing dir, globbing, persistent cache)
  • Note about file handles like in this comment
  • Maybe the authentication/caching pages go under an "Advanced" header in the TOC?
  • URI schemes should feature prominently on the homepage/getting started page/methods table, etc. (you have to dig in to find these at the moment)
  • Would be helpful to have some diagrams, especially on the caching page
  • Example usage on the AnyPath page link AnyPath usage page from the AnyPath API reference page.

Style:

コントリビューターガイド