Skip to main content
replaced http://meta.stackoverflow.com/ with https://meta.stackoverflow.com/
Source Link

As stated in this answerthis answer about what the purpose of the "Documentation" site is:

In general: SO Documentation is supposed to be a source of examples of how to achieve specific things in a said technology.

What we usually see in official documentation is a list of APIs without any explanation of how they are supposed to be used, how to achieve specific goals using them or any examples of usage.

The idea is to complement and enhance such official documentation.

This is definitely useful, but definitely not full documentation. I don't like "Examples" as a name (though I like it better than "Documentation"), but it seems like the sorts of things we want to build already have other well-established names in programming/technology communities:

  • Recipes
  • How-tos
  • Guides
  • Samples
  • Tutorials, or Walkthroughs (iffy, not sure we'd want to sequentialize a topic)

I'm not clever with names, but maybe something snappy can be built from these familiar terms.

As stated in this answer about what the purpose of the "Documentation" site is:

In general: SO Documentation is supposed to be a source of examples of how to achieve specific things in a said technology.

What we usually see in official documentation is a list of APIs without any explanation of how they are supposed to be used, how to achieve specific goals using them or any examples of usage.

The idea is to complement and enhance such official documentation.

This is definitely useful, but definitely not full documentation. I don't like "Examples" as a name (though I like it better than "Documentation"), but it seems like the sorts of things we want to build already have other well-established names in programming/technology communities:

  • Recipes
  • How-tos
  • Guides
  • Samples
  • Tutorials, or Walkthroughs (iffy, not sure we'd want to sequentialize a topic)

I'm not clever with names, but maybe something snappy can be built from these familiar terms.

As stated in this answer about what the purpose of the "Documentation" site is:

In general: SO Documentation is supposed to be a source of examples of how to achieve specific things in a said technology.

What we usually see in official documentation is a list of APIs without any explanation of how they are supposed to be used, how to achieve specific goals using them or any examples of usage.

The idea is to complement and enhance such official documentation.

This is definitely useful, but definitely not full documentation. I don't like "Examples" as a name (though I like it better than "Documentation"), but it seems like the sorts of things we want to build already have other well-established names in programming/technology communities:

  • Recipes
  • How-tos
  • Guides
  • Samples
  • Tutorials, or Walkthroughs (iffy, not sure we'd want to sequentialize a topic)

I'm not clever with names, but maybe something snappy can be built from these familiar terms.

Source Link
Jacob
  • 78.8k
  • 17
  • 16

As stated in this answer about what the purpose of the "Documentation" site is:

In general: SO Documentation is supposed to be a source of examples of how to achieve specific things in a said technology.

What we usually see in official documentation is a list of APIs without any explanation of how they are supposed to be used, how to achieve specific goals using them or any examples of usage.

The idea is to complement and enhance such official documentation.

This is definitely useful, but definitely not full documentation. I don't like "Examples" as a name (though I like it better than "Documentation"), but it seems like the sorts of things we want to build already have other well-established names in programming/technology communities:

  • Recipes
  • How-tos
  • Guides
  • Samples
  • Tutorials, or Walkthroughs (iffy, not sure we'd want to sequentialize a topic)

I'm not clever with names, but maybe something snappy can be built from these familiar terms.