Template:Ongoing discussions/doc: Difference between revisions
(Doc for WIP ongoing discussions template (see Valve_Developer_Community:Discussion for context)) |
(Integrated compact mode) |
||
Line 39: | Line 39: | ||
{{CodeBlock|<nowiki>{{Ongoing discussions|float=left|width=20%}}</nowiki>}} | {{CodeBlock|<nowiki>{{Ongoing discussions|float=left|width=20%}}</nowiki>}} | ||
{{clr}} | |||
<hr> | |||
=== Compact mode === | |||
This template can optionally use a more compact appearance which hides the image and generic discussion links near the top of the box. For example: | |||
{{CodeBlock|<nowiki>{{Ongoing discussions|float=left|compact=yes}}</nowiki>}} | |||
{{clr}} | |||
{{Ongoing discussions/core | |||
| general = (links to general discussions) | |||
| meta = (links to meta discussions) | |||
| float = left | |||
| compact = yes | |||
}} | |||
{{clr}} | |||
There's an even more compact version which removes the template links at the bottom: | |||
{{CodeBlock|<nowiki>{{Ongoing discussions|float=left|compact=very}}</nowiki>}} | |||
{{clr}} | |||
{{Ongoing discussions/core | |||
| general = (links to general discussions) | |||
| meta = (links to meta discussions) | |||
| float = left | |||
| compact = very | |||
}} | |||
{{clr}} |
Revision as of 15:30, 11 July 2024
This template is used to bring attention to active discussions in the Valve Developer Community, particularly discussions which may need consensus or other community attention. It should be placed on prominent community pages and edited when a new discussion is in progress. This is based on Wikipedia's Centralized discussion framework, but it's simplified and less strict to try to meet the needs of a looser community.
Adding discussions
To add a new item to the list of ongoing discussions, edit the Template:Ongoing discussions page. HTML comments will indicate where to add new discussions. When adding a new discussion, place it above any other discussions on its respective list. Note that this list is actually a parameter to another template, so the characters =
and |
cannot be used by default. Use {{=}}
and {{!}}
if you need to use them.
Discussions mentioned on this template should link to a specific topic section. The text representing each link should either match up with the talk page section's name or serve as a short summary of the subject, and it should ideally be short enough to fit on one line in a typical screen width. Discussions which branch off of another ongoing discussion can be listed with indentations.
When you add a new discussion to the list, please include the date when the link was added in an HTML comment (e.g. <!-- Added 1 January 1970 -->
).
Removing discussions
A discussion could be removed from this list if:
- A consensus on the topic is reached, or is no longer needed.
- The discussion hasn't been active in over one month. (this isn't an outright requirement for a discussion to be on the list, just a reason a discussion can be removed)
- The discussion is closed for some other reason.
Usage
(links to general discussions)
(links to meta discussions)
For all discussion activity, see recent changes to talk pages.
This template can be used as-is without any parameters. By default, it floats to the right and takes up 35% of the page. For example:
(links to general discussions)
(links to meta discussions)
For all discussion activity, see recent changes to talk pages.
You can also specify a specific width and/or float parameter. For example:
Compact mode
This template can optionally use a more compact appearance which hides the image and generic discussion links near the top of the box. For example:
(links to general discussions)
(links to meta discussions)
There's an even more compact version which removes the template links at the bottom:
(links to general discussions)
(links to meta discussions)