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.
E. g.: http://stackoverflow.com/documentation/ruby-on-rails/3606/rails-deployment-capistrano-nginx-passenger-postgresqlhttps://stackoverflow.com/documentation/ruby-on-rails/3606/rails-deployment-capistrano-nginx-passenger-postgresql
Another e. g..: http://stackoverflow.com/documentation/ruby-on-rails/3902/configure-angular-with-rails#t=201607280828428093112https://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.