I've been adding some examples to the Ruby on Rails documentation tag and came across a few topics, which have multiple example, which are connected to each other.
Another e. g..: https://stackoverflow.com/documentation/ruby-on-rails/3902/configure-angular-with-rails#t=201607280828428093112
This multi-step examples build together a whole tutorial. A tutorial is not an example in my opinion. I've the following ideas to address this 'problem':
- Declare that examples have to be independent and provide moderation tools to flag examples, which doesn't follow this rule.
- If tutorials are wanted in the documentation too, add a new section besides the examples.