Skip to main content
Post Closed as "Not suitable for this site" by pnuts, Nissa, HaveNoDisplayName, peterh, Stephen RauchMod
replaced http://stackoverflow.com/ with https://stackoverflow.com/
Source Link

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.

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-postgresql

Another e. g..: http://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.

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.: https://stackoverflow.com/documentation/ruby-on-rails/3606/rails-deployment-capistrano-nginx-passenger-postgresql

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.
added 130 characters in body
Source Link
Robin
  • 8.5k
  • 14
  • 6

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-postgresql

Another e. g..: http://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.

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-postgresql

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.

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-postgresql

Another e. g..: http://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.
Source Link
Robin
  • 8.5k
  • 14
  • 6

Are multi-step examples wanted, in the documentation?

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-postgresql

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.