How to handle various types of Topics
To structure this: Define what the Topic type means, give some examples, then explain how we want it handled -- Do we want it here? If so, how should it be linked to other Topics or tags?
Tasks
A task is like a question in Q&A, but broader, ideally serving as a reference for many questions.
To the extent that a task relies on packages or other exotic tools, it should link to Topics for those tools. Similarly, to the extent that an Example is entirely about a given Topic (e.g., Subsetting rows and columns from a data frame is entirely about the concept of Subsetting), it should link there. Linking back and forth reduces duplication and allows Docs editors to find and fix errors more easily.
If a task is so broad that it cannot fit under a single Topic, (i) break it up into several; (ii) make a meta-task Topic; (iii) link back and forth between the meta-task and the others; and (iv) make sure each example under the meta-task still has runnable code with verbal explanations. For an example, see the meta-task Input and output, which has an example tying together Topics about various tabular-data formats; and should eventually get examples for spatial-data formats, graph data format, etc.
Tools
A tool Topic is about a data structure, function, package or other tool that can be used with R.
For packages, if it has its own tag and Docs, those should be linked prominently. If not, it is very likely that the package will require multiple topics (of various types: tasks, tools, whatever). These should all link back and forth with the "main" Topic about the package. For example, Shiny reactivity and Shiny should be linked.
For a single function, might as well try to use the Syntax and Parameters sections of the Topic page.
We should not have "List all the things" Topics, like Data Types with Examples "Logicals", "Dates", etc., for two reasons: these are not real examples and we will run out of space for them in short order (since the number of Examples is capped).
Methods
A method Topic is about a way of performing data analysis, taken from statistics or elsewhere.
If a specific package or exotic tool is used, its Docs should be linked.
If a Topic is too broad, break it up and link to a top-level Topic (like Random Forest Algorithm and Machine learning should be linked).
Concepts
A concept Topic is what it sounds like.
These should use the Introduction and Remarks section to introduce the Topic and then consist of Examples illustrating the concept. So, "Literate Programming" is not a good Example -- it belongs in the Remarks, while a real example might show how to use it to do something.
Meta
A meta Topic is about R Docs. Examples:
For now, let's leave these alone if they are on Docs. Eventually, we might want to move everything except the "Getting started" content to meta.