User talk:PeerInfinity/Scripts/SyncArticleLinks.php

From LessWrong
Jump to navigation Jump to search

Script-enforced policies

The current version of this script attempts to enforce the following policies. As of Oct. 24, 2009, these policies are entirely unofficial, and some of them are really bad ideas. This script is still a work in progress.

  • Wiki pages should not include unnecessary <!-- html comments ––>. One of the wiki's old templates used to automatically insert comments into every wikipage where it was used, and that just caused unnecessary clutter.
  • Pages should not include the headings "Overcoming Bias Articles" or "Less Wrong Articles", but instead should use the heading "Blog posts".
  • Pages should not include the heading "External references", but instead should use the heading "References".
  • Pages should not include the heading "See Also", but instead should use the heading "See also". (because of the capitalization rules)
  • Author links should not link directly to an external site. Instead, a wiki page should be created for the author, and that page should include the external link.
  • The {{wikilink}} template should not have two newline characters after it. This causes an empty space to appear at the top of the article. There should only be one newline character between the {{wikilink}} template and the next line of text.
  • The "See also" section should appear after the "Blog posts" section, not before.
  • The title of links to Less Wrong blog posts should appear exactly the same as the title of the original blog post, with the same capitalization. There is a list of allowed exceptions to this rule, and more exceptions can be added as appropriate.
  • If a short summary is available for a Less Wrong blog post, then the summary should appear on every wiki page that contains a link to that post. For a list of available summaries, see Less Wrong/Article summaries.
    • "If a short summary is available for a Less Wrong blog post, then the summary should appear on every wiki page that contains a link to that post." is also a bad idea: it enforces duplication of text and requires independence of context. Also, we have plain too little data on how summaries tend to form, as almost no summaries are present, except for sequences. --Vladimir Nesov 21:05, 24 October 2009 (UTC)
      • I agree. Sorry again for the trouble I caused. No, I haven't started enforcing this rule yet. So far I set up the script to report a list of summaries that are available, and today I manually added a few of the summaries to see if you would change them back. Other than that, this rule isn't being enforced.--PeerInfinity 21:50, 24 October 2009 (UTC)
  • Any Concept page must include at least one link to a Less Wrong blog post or external reference. If the page doesn't contain any such link, then the page is either "original research", or a page stub.
  • The Less Wrong/All articles page should be synchronized with the rest of the wiki. It's easier to let the script do this automatically than to try to update the All Articles page manually.
  • If one page contains a link to a second page in its "See also" section, then the second page should also include a link to the first page in its "See also" section.
    • By the way, requiring "see also" to be symmetric is generally a bad idea. For example, if some concept is fairly useful and is added in "see also" of a lot of other concepts, it doesn't follow that all these concepts are relevant for that one concept and should be included in its "see also" section. "See also" selects only the most relevant other articles, and sometimes there is a tradoff so that some relevant articles have to be removed from the section, because there are too many (it should become more pressing later in the wiki's lifetime). I wasn't following for the last few weeks, but I hope you haven't enforced it yet. --Vladimir Nesov 21:05, 24 October 2009 (UTC)
      • I agree. Sorry again for the trouble I caused. No, I haven't started enforcing this rule yet. So far I set up the script to report a list of the "See also" links that only go one way, and today I manually added a few of the links to see if you would change them back. Other than that, this rule isn't being enforced.--PeerInfinity 21:50, 24 October 2009 (UTC)

These changes are not made automatically, but instead any page that violates these formatting rules is reported in the script output page. The pages are then edited manually to fix any formatting issues.

If you want to add an exception or other change to these rules, then post a comment to the cleanup script's discussion page.


Requests for changes

If you want to request any changes to the wiki's Script-enforced policies, then please post your request here.