Skip to main content
Commonmark migration
Source Link

##Feature Request

Feature Request

It would be nice to have a meta-topic within the documentation for each of the tags where users could suggest and vote on best practices and standards for the examples/topics in that tag. (Like meta votes these would confer no reputation.) The topic would be linked to the tag's dashboard, and could be optionally linked in the "Create Topic" UI. This would allow:

  • Tag-specific guidelines to be developed such that each tag's documentation can be internally consistent.
  • All users to weigh in on the merits of each suggestion through the tried-and-true method of voting up and down.
  • Engagement with the users who cannot or will not go to chat
  • Presenting best practices for each tag's documentation in an easy-to-browse way. (At least easier than searching through the chat's transcript.)

A couple examples:

  • : Don't introduce multiple concepts in an example. In an example that uses design pattern X, don't also use design pattern Y. [Replace X and Y with whatever patterns apply]
  • : Wherever possible, include links to the canonical/official documentation. [like MSDN, python.org, the iOS Developer Library, etc.]
  • : For basic language features (inheritance, explicit interface implementation, etc), avoid using the new lambda-bodied method syntax [snipped discussion of why...]
  • : Prefer the use of NULL over nullptr for examples, so that they are valid in C as well as C++.
  • : As much as possible, examples should conform to the PEP-8 style guide.

Note that these examples are just that, not a suggestion that they should be the ruling conventions for their respective tags.

Meta Note: I've made this post CW, so feel free to add clarifications or tweak the idea. (As long as the general thrust of the suggestion remains, obviously.)

##Feature Request

It would be nice to have a meta-topic within the documentation for each of the tags where users could suggest and vote on best practices and standards for the examples/topics in that tag. (Like meta votes these would confer no reputation.) The topic would be linked to the tag's dashboard, and could be optionally linked in the "Create Topic" UI. This would allow:

  • Tag-specific guidelines to be developed such that each tag's documentation can be internally consistent.
  • All users to weigh in on the merits of each suggestion through the tried-and-true method of voting up and down.
  • Engagement with the users who cannot or will not go to chat
  • Presenting best practices for each tag's documentation in an easy-to-browse way. (At least easier than searching through the chat's transcript.)

A couple examples:

  • : Don't introduce multiple concepts in an example. In an example that uses design pattern X, don't also use design pattern Y. [Replace X and Y with whatever patterns apply]
  • : Wherever possible, include links to the canonical/official documentation. [like MSDN, python.org, the iOS Developer Library, etc.]
  • : For basic language features (inheritance, explicit interface implementation, etc), avoid using the new lambda-bodied method syntax [snipped discussion of why...]
  • : Prefer the use of NULL over nullptr for examples, so that they are valid in C as well as C++.
  • : As much as possible, examples should conform to the PEP-8 style guide.

Note that these examples are just that, not a suggestion that they should be the ruling conventions for their respective tags.

Meta Note: I've made this post CW, so feel free to add clarifications or tweak the idea. (As long as the general thrust of the suggestion remains, obviously.)

Feature Request

It would be nice to have a meta-topic within the documentation for each of the tags where users could suggest and vote on best practices and standards for the examples/topics in that tag. (Like meta votes these would confer no reputation.) The topic would be linked to the tag's dashboard, and could be optionally linked in the "Create Topic" UI. This would allow:

  • Tag-specific guidelines to be developed such that each tag's documentation can be internally consistent.
  • All users to weigh in on the merits of each suggestion through the tried-and-true method of voting up and down.
  • Engagement with the users who cannot or will not go to chat
  • Presenting best practices for each tag's documentation in an easy-to-browse way. (At least easier than searching through the chat's transcript.)

A couple examples:

  • : Don't introduce multiple concepts in an example. In an example that uses design pattern X, don't also use design pattern Y. [Replace X and Y with whatever patterns apply]
  • : Wherever possible, include links to the canonical/official documentation. [like MSDN, python.org, the iOS Developer Library, etc.]
  • : For basic language features (inheritance, explicit interface implementation, etc), avoid using the new lambda-bodied method syntax [snipped discussion of why...]
  • : Prefer the use of NULL over nullptr for examples, so that they are valid in C as well as C++.
  • : As much as possible, examples should conform to the PEP-8 style guide.

Note that these examples are just that, not a suggestion that they should be the ruling conventions for their respective tags.

Meta Note: I've made this post CW, so feel free to add clarifications or tweak the idea. (As long as the general thrust of the suggestion remains, obviously.)

Source Link
theB
  • 6.7k
  • 2
  • 29
  • 42

##Feature Request

It would be nice to have a meta-topic within the documentation for each of the tags where users could suggest and vote on best practices and standards for the examples/topics in that tag. (Like meta votes these would confer no reputation.) The topic would be linked to the tag's dashboard, and could be optionally linked in the "Create Topic" UI. This would allow:

  • Tag-specific guidelines to be developed such that each tag's documentation can be internally consistent.
  • All users to weigh in on the merits of each suggestion through the tried-and-true method of voting up and down.
  • Engagement with the users who cannot or will not go to chat
  • Presenting best practices for each tag's documentation in an easy-to-browse way. (At least easier than searching through the chat's transcript.)

A couple examples:

  • : Don't introduce multiple concepts in an example. In an example that uses design pattern X, don't also use design pattern Y. [Replace X and Y with whatever patterns apply]
  • : Wherever possible, include links to the canonical/official documentation. [like MSDN, python.org, the iOS Developer Library, etc.]
  • : For basic language features (inheritance, explicit interface implementation, etc), avoid using the new lambda-bodied method syntax [snipped discussion of why...]
  • : Prefer the use of NULL over nullptr for examples, so that they are valid in C as well as C++.
  • : As much as possible, examples should conform to the PEP-8 style guide.

Note that these examples are just that, not a suggestion that they should be the ruling conventions for their respective tags.

Meta Note: I've made this post CW, so feel free to add clarifications or tweak the idea. (As long as the general thrust of the suggestion remains, obviously.)

Post Made Community Wiki by theB