drivendataorg/cloudpathlib

Documentation updates content + style

開放

#133 建立於 2021年3月13日

 (1 則留言) (0 個反應) (0 位負責人)Python (87 個分叉)auto 404
documentationgood first issue

倉庫指標

星標
 (624 顆星)
PR 合併指標
 (PR 指標待抓取)

描述

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:

貢獻者指南