nimblepkgstructure.md

First suggestion:

src/
  <pkgname>.nim
tests/
docs/
<pkgname>.nimble # with srcDir = "src"

library with single module

<pkgname>.nim
<pkgname>.nimble # with skipDirs = @["tests","docs"]
tests/
docs/

library with multiple modules

<pkgname>/
  private/ # optional
    priv1.nim
    priv2.nim
  module1.nim
  module2.nim
<pkgname>.nimble # with skipDirs = @["tests","docs"]
tests/
docs/

binary

<pkgname>.nim
<pkgname>.nimble # with bin = @["<pkgname>"]

hybrid

<pkgname>pkg/
  private/ # optional
    priv1.nim
    priv2.nim
  module1.nim
  module2.nim
<pkgname>.nim
<pkgname>.nimble # with bin = @["<pkgname>"]

bonus: what I do:

src/
  <pkgname>.nim
  <pkgname>/
    private/ # optional
      priv1.nim
      priv2.nim
    module1.nim
    module2.nim
<pkgname>.nimble # with srcDir = "src"
tests/
docs/

stisa/nimblepkgstructure.md