cmd ref: review description of init and related commands (per --subdir) #1039
Labels
A: docs
Area: user documentation (gatsby-theme-iterative)
C: ref
Content of /doc/*-reference
type: discussion
Requires active participation to reach a conclusion.
type: enhancement
Something is not clear, small updates, improvement suggestions
Discussion part:
I also think (already discussed with Ivan) that the result here is a little too long. We went from 2 paragraphs to 21 plus block codes. It's not necessarily a problem because all of this info is valuable, but I think in part it can be summarized at least a little, and possibly extract these advanced cases into the user guide (as suggested above). We even state that they are "rare", so I'm not sure it's worth explaining them in detail in the description of this cmd ref. Another option is to make them into examples and keep the direct links from the description. Food for thought.
The text was updated successfully, but these errors were encountered: