维基百科:整理討論

维基百科,自由的百科全书

整理討論(重構,英語:Refactoring)是改善討論結構的步驟,頁面內容可能被移動、刪除、修改、重組、隱藏或其他方式,但僅適用於有編者簽署語句(如用戶頁或對話頁)的地方。整理讨论有以下作用:

  • 改善頁面的清晰度和可讀性
  • 去除離題、不文明、含糊、或其他分散注意力的材料
  • 重組討論使條理清晰
  • 將材料易位至其他更合適的章節或頁面

比起编修,重构更加简要概括,但不像存档那样能够反映完整的事实。重构能够像编修一样保留作者的原意和目的,但可能像存档一样涉及删除当时曾经存在的文字。重構應當視為一項工具,從「飛快的」討論中分離不需要的雜質,而不等待整個討論正式歸檔。

用語「重構」來自電腦運算的代碼重構,代碼重組(以改善品質)而不改變程式運作。

良好施行重構對維護有成效的討論頁面至關重要。雜亂、仇敵、過於複雜、結構不良、或交叉談論造成擁塞的討論頁面,會使潛在貢獻者喪氣和產生誤會侵蝕了討論的成果。

重構應當僅由討論頁面的參與者基於假定善意執行。若討論頁最近正在激烈地讨论,突然进行重构可能缺乏善意。如果其他編者反對,應該還原重構所造成的變化。不過若該頁面超過了建議大小,無需重構仍然可以存檔該討論頁或近期沒有發言的章節。

概述

在过去的維基百科,尤其在2006年以前,討論頁的內容會替換為简要总结来節省空間──这是一種会丢失原文的重構方法。然而,后来社群開始將討論頁內的討論內容整體存檔,因為存檔可以保存更完整的討論,不會導致其他編者的意見被错误表达(無論是純屬意外或故意扰乱),並保留未來可能有用的资料。同樣的原則也開始更廣泛地使用在重構上。

依據規則,編輯者應避免影響其他編輯者所要表達的意義,而不應編輯其他編輯者的留言──這麼做可能會導致陳述被歪曲,會話被打斷,並且影響其他用戶跟進討論。但一些情形下編輯者的發言需要被移除,因為其發言本身擾亂了會話。一般而言,下列情形整理討論是没有问题的:

非爭議性清理——在任何您能確定其他編者會感謝,而不會感到不快的情況,例如:

  • 補上遺漏的標題和標示
  • 按照維基格式更正段落縮進
  • 修复死链
  • 修復例如維基文本格式、表格、模板等技術問題
  • 改进标题,使其具有总结性
  • 修复错误的签名位置(如文本和签名分离),以及为未签名的文本挂上{{Unsigned}}
  • 其他的小修改(不建議更正其他用戶的語法錯誤,但是更正明顯的錯字還是可以接受的)

改变讨论结构——请注意不能改变讨论原意:

  • 根据不同的议题,把文字分成几个章节
  • 把文字放到更合适的位置
  • 把一段文字移动或复制到不同的章节,针对这一章节发起更集中的讨论

删减会话——只有取得原作者同意,或者依照方针有合理的理由才可以这么做:

  • 删除、划掉、或者隐藏人身攻击
  • 隐藏多余的、过时的、或者其他不必要内容
  • 将会话迁移到更适合存放的页面

如何重構

依據維基百科的討論頁指引,鼓勵編輯者移除任何認定為不適當的內容。只有在移除的會話在其他編輯者的會話中有所提及的情況下,才應該添加指向討論頁歷史的鏈接。關於創建指向會話頁歷史鏈接,參見Help:差异;關於不合宜的會話內容,參見Wikipedia:討論頁指引

在這裡有數種可用於重構的工具與技術:

刪除
編輯並將文字完全刪除。Except for non-contentious fixes, this should only be done by the editor who wrote the material or by a sysop or bureaucrat with legitimate cause. Unless a sysop uses Oversight, RevDel, or a page has been deleted entirely, the deleted text will still appear in old revisions of the page.
劃線
使用HTML的劃線語法─「<s>被劃線文字</s>」會產生「被劃線文字」。此段文字仍將會在其頁面中讀取,也會顯示在頁面搜尋當中。
Moving text off-page
Material can be userfied or moved to a different page where it is more appropriate. If the refactoring is later reverted, the moved material should be deleted on the pages it was moved to prevent proliferation of the text.
Hidden divs, collapsible tables, and templates
A number of tools and templates hide or block text from further editing – {{hidden}}, {{cot}}, {{hat}}, {{archive top}}, {{discussion top}}. These work by creating collapsible tables or hidden divs. Material collapsed in this fashion does not show up in page searches unless it is in an expanded state.

The tool or technique used should be chosen according to the particular needs of the material.

The creation of an FAQ is recommended for any points that are likely to be repeatedly raised and refactored. Existing material should be generalized appropriately and reformatted into a simple question/answer format so that later editors can have their concerns satisfied without raising the question again. Likewise, lengthy ongoing discussions might benefit from template refactoring with a summary. The {{quote box}} template can be used to provide a floating summary box next to a refactored discussion, or a comment may be added at the bottom (or sometimes the top) of a section.

截除

In some cases, discussion should be broken down into new sections or subsections. This is useful when a section becomes overly long, or when conversation begins to diverge into a number of separate points. Resectioning may help both readers and participants understand the flow of the discussion and help them find relevant parts of the text.

For long discussions, participants often insert arbitrary breaks by adding a new subsection heading. In fact, such breaks are often given headings like 'Arbitrary break' or 'convenience break', with an index number to distinguish it from other arbitrary break headings. Discussions that cover multiple points or become more complex, by contrast, may benefit from the creation of subsections to address different points, or in extreme cases by splitting off sections of text into entirely new sections. It may be necessary in these cases to reorganize large swatches of text, and if so care should be taken to ensure that no comments are taken out of context or lose connection with the original point they were addressing. It may be advisable to copy sections of text rather than move them (adding a comment that refers back to the original text), to duplicate the original author's signature across different points that have been moved to different sections, or to begin the new section with a parenthetical statement explaining the original context of the comment.

請參考下面的範例

考量

在進行重構時,應注意以下考量:

  • Refactoring may cause confusion if improperly applied to an ongoing discussion; an editor should take great care to preserve all such discussion and all relevant details to its context.
  • Editors should be conscious of the newcomer's perspective; one should not remove content that would benefit an editor who had not yet read the page.

Be aware that not every editor will agree with your refactoring or even of the refactoring concept in general. Provide links to the original, uncut version, so others can check your changes, and if necessary go back to the original to clarify what an author actually said. This combination of refactoring and archiving will often prevent complaints that information was lost. Make it explicit that you have refactored something so no one is misled into thinking this was the original talk page.

If you think people may object to their discussion being refactored, make your summary on a different page. Rather than reducing archives 7 to 10 of Talk:New Imperialism, create a new page entitled [[Talk:New Imperialism/Summary of archives 7 to 10]]. Link this to the top of the appropriate archives, and to the current talk page. This gives newcomers the chance to get a quick understanding without the risk of losing what has gone before. Having a linked archive can help satisfy both those who feel their words must remain intact and those who want a neat summary.

進階工具

Simple refactoring can easily be done with standard Wikipedia browser editing, but if you are faced with a particularly complex or tedious refactoring job, an advanced text editor or any of an assortment of scripting languages can be immensely helpful. Basically, any tool that has extended find and replace features, regular expression capabilities, or programmatic text processing will become your best friend. Alphabetizing material, sorting sections into chronological order, changing multiple links, restructuring large tables – these tasks can be painful and time consuming to do by hand, but can be accomplished in a matter of minutes programmatically. Most high-end 'Office'-type have advanced text editing capabilities, and many light-weight but powerful text editing applications are available – see list of text editors. Many scripting languages for text processing also exist; common ones are Perl, Python, Unix shell scripting, and AppleScript.

For long refactoring jobs, it may help to tag the page(s) being refactored with Template:Refactoring. Simply add {{refactoring}} to the top of the page(s). This will alert other editors to the fact that the pages are under construction, and should help minimize edit conflicts.

明顯範例

Talk pages or talk page sections that have benefited from refactoring:

參見

外部連結