| Revision as of 22:15, 20 August 2012 editNettrom (talk | contribs)Extended confirmed users4,600 edits reverting back to an older revision now that our automated trial is complete← Previous edit | Revision as of 18:07, 22 August 2012 edit undoNettrom (talk | contribs)Extended confirmed users4,600 editsm Undid revision 508358852 by Nettrom (talk) - the bot request was approved, switching back to template instructionsNext edit → | ||
| Line 1: | Line 1: | ||
| This page explains how to try ] out by making it send you suggestions only once. We use a template for this because it is relatively easy to use, while also making us able to automate the process of sending out suggestions. As this document will explain, it also provides you with the possibility to influence what pages the suggestions are based on. SuggestBot removes the template automatically at the same time as it sends you the suggestions, thus ensuring that you only get suggestions once. If you are wondering what SuggestBot is and how it works, please see ]. | |||
| == What is SuggestBot? == | |||
| How you make SuggestBot send you suggestions depends on what you already have done: | |||
| For a description of what SuggestBot is and how it works, please see ]. | |||
| * If you haven't already edited any pages you need to ]. | |||
| ==I want to try personalized SuggestBot suggestions for articles to edit== | |||
| * If you have already edited pages you may: | |||
| ** get suggestions ], or | |||
| ** get suggestions ]. | |||
| Should anything in this documentation be confusing or unclear, we appreciate questions and suggestions for improvements on ]. | |||
| Some people have asked if they can get suggestions on a regular basis, and we have written ] to receive those automatically. | |||
| == Suggestions based on the pages you've edited == | |||
| Please leave your name below. You'll get suggestions posted to your user talk page in the not too distant future, which currently usually means less than a couple of days or so as handling them is a semi-automated task. Once you get a chance to explore your suggestions, any ] you can give will help us improve the bot's functionality. Thanks for your interest! -- ] (]) 15:46, 7 October 2010 (UTC) | |||
| This is the way SuggestBot usually works, it fetches your last few hundred edits and suggests articles that are similar and in need of improvement. To get such a set of suggestions, add the following code to your user talk page: | |||
| '''Your username below (at the bottom of this section, please):''' | |||
| <pre style="overflow: auto"> | |||
| * ] | |||
| {{User:SuggestBot/suggest}} | |||
| </pre> | |||
| You can also add this template code to a page in your userspace (e.g. "User:Example/Suggestions") and have them posted there instead of on your user talk page. We look for users who have added the template code at regular intervals, so you should therefore get the suggestions fairly quickly, usually within about fifteen minutes. | |||
| == Your suggestions have been posted == | |||
| == Suggestions based on specific pages == | |||
| If your name used to be on this list, we've posted suggestions to your user talk page. Should you find that you've either been removed in error, or think you have been waiting too long for suggestions, please ]. | |||
| : I really enjoyed the suggestions I got, thanks so much! ]] 19:22, 27 January 2011 (UTC) | |||
| You can tell SuggestBot exactly which pages it should base its suggestions on, which gives you the opportunity to potentially receive a set of suggestions limited to a certain area of interest. If you do this the bot will not look at your recent edits and can therefore end up suggesting articles you've recently edited, but it will not suggest any of the articles you've specified. | |||
| As an example, let's assume you are interested in ] and ]. Misplaced Pages has specific pages about these subjects, so we can specify that SuggestBot should use these as the basis of the suggestions by listing them in the template code separated by "|", like this: | |||
| <pre style="overflow: auto"> | |||
| {{User:SuggestBot/suggest|World War I|World War II}} | |||
| </pre> | |||
| Unfortunately SuggestBot does not work very well with such a low number of pages, which is why we have also made it possible to specify names of Misplaced Pages categories, which it will then fetch page titles from. Going back to our example using World War I & II, we can use the fact that Misplaced Pages also has categories about these subjects (] and ]) and tell SuggestBot to use all the articles from these categories: | |||
| <pre style="overflow: auto"> | |||
| {{User:SuggestBot/suggest|Category:World War I|Category:World War II}} | |||
| </pre> | |||
| SuggestBot will use up to 128 pages from the listed categories and post suggestions based on those. It does not look at subcategories, so if a category has a subcategory you are interested in you will also have to list the subcategory. It is of course also possible to mix pages and categories in the listing, like this: | |||
| <pre style="overflow: auto"> | |||
| {{User:SuggestBot/suggest|World War I|World War II|Category:Politics of World War II}} | |||
| </pre> | |||
| In summary the template code consists of the name of the template ("User:SuggestBot/suggest") followed by either "|" and the title of a page, or "|" and the title of a category, as many times as necessary. More formally defined using the ], the format of the template code for a "suggestion" is as follows: | |||
| <pre style="overflow: auto"> | |||
| suggestion = "{{" TemplateName "}}" | |||
| TemplateName = "User:SuggestBot/suggest" | |||
| Pages = { "|" PageOrCategory } | |||
| PageorCategory = PageTitle | CategoryTitle | |||
| // PageTitle is the title of a page, e.g. "World War I" | |||
| // CategoryTitle is the title of a category including "Category:", e.g. "Category:World War I" | |||
| </pre> | |||
| ] | |||
| ] | |||
Revision as of 18:07, 22 August 2012
This page explains how to try SuggestBot out by making it send you suggestions only once. We use a template for this because it is relatively easy to use, while also making us able to automate the process of sending out suggestions. As this document will explain, it also provides you with the possibility to influence what pages the suggestions are based on. SuggestBot removes the template automatically at the same time as it sends you the suggestions, thus ensuring that you only get suggestions once. If you are wondering what SuggestBot is and how it works, please see SuggestBot.
How you make SuggestBot send you suggestions depends on what you already have done:
- If you haven't already edited any pages you need to tell SuggestBot what you're interested in.
- If you have already edited pages you may:
- get suggestions based on the pages you've edited, or
- get suggestions based on a specific set of pages.
Should anything in this documentation be confusing or unclear, we appreciate questions and suggestions for improvements on our talk page.
Suggestions based on the pages you've edited
This is the way SuggestBot usually works, it fetches your last few hundred edits and suggests articles that are similar and in need of improvement. To get such a set of suggestions, add the following code to your user talk page:
{{User:SuggestBot/suggest}}
You can also add this template code to a page in your userspace (e.g. "User:Example/Suggestions") and have them posted there instead of on your user talk page. We look for users who have added the template code at regular intervals, so you should therefore get the suggestions fairly quickly, usually within about fifteen minutes.
Suggestions based on specific pages
You can tell SuggestBot exactly which pages it should base its suggestions on, which gives you the opportunity to potentially receive a set of suggestions limited to a certain area of interest. If you do this the bot will not look at your recent edits and can therefore end up suggesting articles you've recently edited, but it will not suggest any of the articles you've specified.
As an example, let's assume you are interested in World War I and World War II. Misplaced Pages has specific pages about these subjects, so we can specify that SuggestBot should use these as the basis of the suggestions by listing them in the template code separated by "|", like this:
{{User:SuggestBot/suggest|World War I|World War II}}
Unfortunately SuggestBot does not work very well with such a low number of pages, which is why we have also made it possible to specify names of Misplaced Pages categories, which it will then fetch page titles from. Going back to our example using World War I & II, we can use the fact that Misplaced Pages also has categories about these subjects (Category:World War I and Category:World War II) and tell SuggestBot to use all the articles from these categories:
{{User:SuggestBot/suggest|Category:World War I|Category:World War II}}
SuggestBot will use up to 128 pages from the listed categories and post suggestions based on those. It does not look at subcategories, so if a category has a subcategory you are interested in you will also have to list the subcategory. It is of course also possible to mix pages and categories in the listing, like this:
{{User:SuggestBot/suggest|World War I|World War II|Category:Politics of World War II}}
In summary the template code consists of the name of the template ("User:SuggestBot/suggest") followed by either "|" and the title of a page, or "|" and the title of a category, as many times as necessary. More formally defined using the Extended Backus–Naur Form, the format of the template code for a "suggestion" is as follows:
suggestion = "{{" TemplateName "}}"
TemplateName = "User:SuggestBot/suggest"
Pages = { "|" PageOrCategory }
PageorCategory = PageTitle | CategoryTitle
// PageTitle is the title of a page, e.g. "World War I"
// CategoryTitle is the title of a category including "Category:", e.g. "Category:World War I"