Make great documentation goal 1.2, and plan the README's reorganisation and the nested-template gaps #33
+2
-3
@@ -116,9 +116,8 @@ func New(opts ...Option) (*Generator, error) {
|
||||
}
|
||||
|
||||
// List returns the sorted dotted paths Fake can render: every category, the dotted
|
||||
// fields within a template, and folder segments. A choice consumes no segment, so a
|
||||
// path continues through one only where every variant carries it, which is the
|
||||
// rule Fake applies too.
|
||||
// fields within a template. A choice consumes no segment, so a path continues
|
||||
// through one only where every variant carries it, which is the rule Fake applies too.
|
||||
func (f *Generator) List() []string {
|
||||
var out []string
|
||||
for _, name := range sortedNames(f.categories) {
|
||||
|
||||
@@ -109,8 +109,7 @@ type renderEdge struct {
|
||||
|
||||
func (e renderEdge) readsRef() bool { return isRef(e.read.key) }
|
||||
|
||||
// reached names an edge as the author spelled it, the vocabulary pathKeyReaders uses
|
||||
// for the sibling fence.
|
||||
// reached names an edge as the author spelled it.
|
||||
func (e renderEdge) reached() string {
|
||||
if e.operand != "" {
|
||||
return fmt.Sprintf("%s operand %q", e.operand, e.label)
|
||||
|
||||
@@ -6,7 +6,7 @@ import (
|
||||
)
|
||||
|
||||
// rng is the randomness a builtin sample draws from; *rand.Rand satisfies it. The
|
||||
// render path takes the concrete *session instead, for the reason below.
|
||||
// render path takes the concrete *session instead.
|
||||
type rng interface {
|
||||
IntN(n int) int
|
||||
Float64() float64
|
||||
|
||||
@@ -23,9 +23,6 @@ Shape 5.8, Self-sufficiency 5.7), every seat capped by Locality, all nine naming
|
||||
|
||||
This round, in order:
|
||||
|
||||
- Correct the false comments: `List` claims folder segments, which `paths` never lists,
|
||||
and `renderEdge.reached` claims `pathKeyReaders`' vocabulary, which spells a token
|
||||
`token {x}`. Drop `rng`'s "for the reason below", which points at `pick`.
|
||||
- Run the nine-seat panel again and file what it names here.
|
||||
|
||||
### Data
|
||||
|
||||
Reference in New Issue
Block a user