version=pmwiki-2.2.130 ordered=1 urlencoded=1 agent=Mozilla/5.0 (Windows NT 5.1; rv:68.0) Gecko/20100101 Goanna/4.8 Firefox/68.0 Mypal/29.3.0 author=mkf charset=UTF-8 csum= ctime=1597970360 host=198.251.81.133 name=Debate.Wikistyle rev=26 targets= text=# Use simple English.%0a # Don't write like an academic.%0a # Never use the word '''one''' when you mean '''you''':%0a # '''Wrong''': One should install the package by running @@$ doas pkg_add tcl@@%0a # '''Right''': @@$ doas pkg_add tcl@@%0a # Avoid excessive jargon%0a # Define the first use of uncommon abbreviations%0a # Avoid slang%0a# Be concise%0a # '''Wrong''': You have now successfully turned from what was a comment into an actual parameter. You will need to uncomment and set any line that begins with semi-colon (;) character at the beginning of the line for any feature that you want. **Without removing that semi-colon that feature is either disabled or the defaults are used!** %0a # '''Right''': Put a semi-colon (;) in front of a line to comment it out. Remove it to uncomment it.%0a # '''Wrong''': I personally do not condone the notion of using FQDN that does not belong to you, as the consequences of going public with the named servers //can// potentially end up in lawsuits, for falsely misrepresenting a domain name. %0a # '''Right''': Don't use a domain you don't own.%0a# Use the active voice, not the passive.%0a# One paragraph for each new topic, and start each paragraph with a topic sentence%0a# One main topic per page. If you have multiple topics, create multiple pages and link to those pages.%0a# Avoid repeating too much unnecessary content that is already better described elsewhere. %0a # If content is described better on another page, link to that page instead of repeating material. This makes it easier to update and maintain content.%0a # For example, an article about ngircd should not spend too much time talking about the TCP/IP client-server model. Instead, link to that page.%0a# Keep track of the difficulty level of each article and keep it in mind when writing.%0a# Avoid markup that is purely cosmetic. Markup should be used to indicate the structure and meaning of content.%0a# Show don't tell. If you want someone to read a man page, just link to it, don't tell him to type $ man %3ccommand>%0a# It is OK to be opinionated, but defend it with evidence%0a # If there is a strong disagreement, create a separate page or a separate category.%0a# In codeblocks, use %3creplaceable_text> to indicate sections of code that should be replaced with a user-specific value [@ ports = 6667,6697%0a IP = %3c192.168.1.1>@]%0a# Avoid formatting options that only make the text look nice; use tags that convey meaning %0a # '''Right''': codeblocks, tables, Emphasis, Headings, Subheadings, indentation for quotes%0a # '''Wrong''': Horizontal rules, indentation other than quotes%0a# In case if there are multiple guides for same task, sort them. (for example sort IRC Clients based on OS) time=1630078158 author:1630078158=mkf diff:1630078158:1625233694:=4c4%0a%3c # '''Wrong''': One should install the package by running @@$ doas pkg_add tcl@@%0a---%0a> # '''Wrong''': One should install the package by running $ doas pkg_add tcl%0a29,30c29%0a%3c # '''Wrong''': Horizontal rules, indentation other than quotes%0a%3c # In case if there are multiple guides for same task, sort them. (for example sort IRC Clients based on OS)%0a\ No newline at end of file%0a---%0a> # '''Wrong''': Horizontal rules, indentation other than quotes%0a\ No newline at end of file%0a host:1630078158=198.251.81.133 author:1625233694=mistera diff:1625233694:1625233207:=28,29c28,29%0a%3c # '''Right''': codeblocks, tables, Emphasis, Headings, Subheadings, indentation for quotes%0a%3c # '''Wrong''': Horizontal rules, indentation other than quotes%0a\ No newline at end of file%0a---%0a> # '''Right''': codeblocks, tables, Emphasis, Headings, Subheadings%0a> # '''Wrong''': Horizontal rules, indentation%0a\ No newline at end of file%0a host:1625233694=204.111.39.57 author:1625233207=mistera diff:1625233207:1625232643:=27,29c27%0a%3c # Avoid formatting options that only make the text look nice; use tags that convey meaning %0a%3c # '''Right''': codeblocks, tables, Emphasis, Headings, Subheadings%0a%3c # '''Wrong''': Horizontal rules, indentation%0a\ No newline at end of file%0a---%0a> # Do not use the formatting options available with PM wiki, except for Empahsis ('''bold''', ''italics''), headings (!!), subheadings (!!!), links, codeblocks ([@ %3ccode> @]), and tables. If you are unsure of whether to use a formatting option, ask%0a\ No newline at end of file%0a host:1625233207=204.111.39.57 author:1625232643=mistera diff:1625232643:1625232548:=27c27%0a%3c # Do not use the formatting options available with PM wiki, except for Empahsis ('''bold''', ''italics''), headings (!!), subheadings (!!!), links, codeblocks ([@ %3ccode> @]), and tables. If you are unsure of whether to use a formatting option, ask%0a\ No newline at end of file%0a---%0a> # Do not use the formatting options available with PM wiki, except for headings (!!), subheadings (!!!), links, codeblocks ([@ %3ccode> @]), and tables. If you are unsure of whether to use a formatting option, ask%0a\ No newline at end of file%0a host:1625232643=204.111.39.57 author:1625232548=mistera diff:1625232548:1625232529:=27c27%0a%3c # Do not use the formatting options available with PM wiki, except for headings (!!), subheadings (!!!), links, codeblocks ([@ %3ccode> @]), and tables. If you are unsure of whether to use a formatting option, ask%0a\ No newline at end of file%0a---%0a> # Do not use the formatting options available with PM wiki, except for headings (!!), subheadings (!!!), links, and codeblocks ([@ %3ccode> @]), and tables. If you are unsure of whether to use a formatting option, ask%0a\ No newline at end of file%0a host:1625232548=204.111.39.57 author:1625232529=mistera diff:1625232529:1625232427:=27c27%0a%3c # Do not use the formatting options available with PM wiki, except for headings (!!), subheadings (!!!), links, and codeblocks ([@ %3ccode> @]), and tables. If you are unsure of whether to use a formatting option, ask%0a\ No newline at end of file%0a---%0a> # Do not use the formatting options available with PM wiki, except for headings (!!), subheadings (!!!), links, and codeblocks ([@ %3ccode> @])%0a\ No newline at end of file%0a host:1625232529=204.111.39.57 author:1625232427=mistera diff:1625232427:1625230105:=25,27c25,28%0a%3c # In codeblocks, use %3creplaceable_text> to indicate sections of code that should be replaced with a user-specific value [@ ports = 6667,6697%0a%3c IP = %3c192.168.1.1>@]%0a%3c # Do not use the formatting options available with PM wiki, except for headings (!!), subheadings (!!!), links, and codeblocks ([@ %3ccode> @])%0a\ No newline at end of file%0a---%0a> # In codeblocks, use %3creplaceable_text> to indicate sections of code that should be replaced with a user-specific value%0a> %0a> --> [@ ports = 6667,6697%0a> IP = %3c192.168.1.1>@]%0a\ No newline at end of file%0a host:1625232427=204.111.39.57 author:1625230105=mistera diff:1625230105:1625060840:=24,28c24%0a%3c # If there is a strong disagreement, create a separate page or a separate category.%0a%3c # In codeblocks, use %3creplaceable_text> to indicate sections of code that should be replaced with a user-specific value%0a%3c %0a%3c --> [@ ports = 6667,6697%0a%3c IP = %3c192.168.1.1>@]%0a\ No newline at end of file%0a---%0a> # If there is a strong disagreement, create a separate page or a separate category.%0a\ No newline at end of file%0a host:1625230105=204.111.39.57 author:1625060840=jrmu diff:1625060840:1625060515:=22d21%0a%3c # Show don't tell. If you want someone to read a man page, just link to it, don't tell him to type $ man %3ccommand>%0a host:1625060840=198.251.81.119 author:1625060515=jrmu diff:1625060515:1625060441:=20c20%0a%3c # Keep track of the difficulty level of each article and keep it in mind when writing.%0a---%0a> # %0a host:1625060515=198.251.81.119 author:1625060441=jrmu diff:1625060441:1625060354:=20c20%0a%3c # %0a---%0a> # %0a host:1625060441=198.251.81.119 author:1625060354=jrmu diff:1625060354:1625058908:=18,20d17%0a%3c # If content is described better on another page, link to that page instead of repeating material. This makes it easier to update and maintain content.%0a%3c # For example, an article about ngircd should not spend too much time talking about the TCP/IP client-server model. Instead, link to that page.%0a%3c # %0a host:1625060354=198.251.81.119 author:1625058908=jrmu diff:1625058908:1625058868:=18d17%0a%3c # Avoid markup that is purely cosmetic. Markup should be used to indicate the structure and meaning of content.%0a host:1625058908=198.251.81.119 author:1625058868=jrmu diff:1625058868:1625058793:=17d16%0a%3c # Avoid repeating too much unnecessary content that is already better described elsewhere. %0a host:1625058868=198.251.81.119 author:1625058793=jrmu diff:1625058793:1625058721:=17c17%0a%3c # It is OK to be opinionated, but defend it with evidence%0a---%0a> # Be opinionated and defend it with evidence%0a host:1625058793=198.251.81.119 author:1625058721=jrmu diff:1625058721:1604504274:=1,8c1,4%0a%3c # Use simple English.%0a%3c # Don't write like an academic.%0a%3c # Never use the word '''one''' when you mean '''you''':%0a%3c # '''Wrong''': One should install the package by running $ doas pkg_add tcl%0a%3c # '''Right''': @@$ doas pkg_add tcl@@%0a%3c # Avoid excessive jargon%0a%3c # Define the first use of uncommon abbreviations%0a%3c # Avoid slang%0a---%0a> # Talk like a normal human being, not an academic.%0a> # Never use the word '''one''' when you mean '''you''':%0a> # '''Wrong''': One should install the package by running $ doas pkg_add tcl%0a> # '''Right''': @@$ doas pkg_add tcl@@%0a host:1625058721=198.251.81.119 author:1604504274=jrmu diff:1604504274:1597973255:=8,9c8,9%0a%3c # '''Wrong''': I personally do not condone the notion of using FQDN that does not belong to you, as the consequences of going public with the named servers //can// potentially end up in lawsuits, for falsely misrepresenting a domain name. %0a%3c # '''Right''': Don't use a domain you don't own.%0a---%0a> # '''Wrong''': I personally do not condone the notion of using FQDN that does not belong to you, as the consequences of going public with the named servers //can// potentially end up in lawsuits, for falsely misrepresenting a domain name. %0a> # '''Right''': Don't use a domain you don't own.%0a12d11%0a%3c # One main topic per page. If you have multiple topics, create multiple pages and link to those pages.%0a host:1604504274=38.81.163.7 author:1597973255=jrmu diff:1597973255:1597973114:= host:1597973255=38.81.163.143 author:1597973114=jrmu diff:1597973114:1597973097:=13c13%0a%3c # If there is a strong disagreement, create a separate page or a separate category.%0a\ No newline at end of file%0a---%0a> # If there are strong disagreements, create a separate page or even a separate category.%0a\ No newline at end of file%0a host:1597973114=38.81.163.143 author:1597973097=jrmu diff:1597973097:1597971366:=12,13c12%0a%3c # Be opinionated and defend it with evidence%0a%3c # If there are strong disagreements, create a separate page or even a separate category.%0a\ No newline at end of file%0a---%0a> # Be opinionated and defend it with evidence%0a\ No newline at end of file%0a host:1597973097=38.81.163.143 author:1597971366=jrmu diff:1597971366:1597971172:=4c4,5%0a%3c # '''Right''': @@$ doas pkg_add tcl@@%0a---%0a> # @@$ doas pkg_add tcl@@%0a> # Never use a long word where a short one will do.%0a8,9d8%0a%3c # '''Wrong''': I personally do not condone the notion of using FQDN that does not belong to you, as the consequences of going public with the named servers //can// potentially end up in lawsuits, for falsely misrepresenting a domain name. %0a%3c # '''Right''': Don't use a domain you don't own.%0a host:1597971366=38.81.163.143 author:1597971172=jrmu diff:1597971172:1597971060:=7,8c7%0a%3c # '''Wrong''': You have now successfully turned from what was a comment into an actual parameter. You will need to uncomment and set any line that begins with semi-colon (;) character at the beginning of the line for any feature that you want. **Without removing that semi-colon that feature is either disabled or the defaults are used!** %0a%3c # '''Right''': Put a semi-colon (;) in front of a line to comment it out. Remove it to uncomment it.%0a---%0a> # '''Wrong''': %0a host:1597971172=38.81.163.143 author:1597971060=jrmu diff:1597971060:1597971040:=10c10%0a%3c # Be opinionated and defend it with evidence%0a\ No newline at end of file%0a---%0a> # Pick an opinion and defend it%0a\ No newline at end of file%0a host:1597971060=38.81.163.143 author:1597971040=jrmu diff:1597971040:1597970894:=9,10c9%0a%3c # One paragraph for each new topic, and start each paragraph with a topic sentence%0a%3c # Pick an opinion and defend it%0a\ No newline at end of file%0a---%0a> # One paragraph for each new topic, and start each paragraph with a topic sentence%0a\ No newline at end of file%0a host:1597971040=38.81.163.143 author:1597970894=jrmu diff:1597970894:1597970360:=6c6%0a%3c # Be concise%0a---%0a> # If it is possible to cut a word out, always cut it out.%0a8,9c8,9%0a%3c # Use the active voice, not the passive.%0a%3c # One paragraph for each new topic, and start each paragraph with a topic sentence%0a\ No newline at end of file%0a---%0a> # Never use the passive where you can use the active.%0a> # Never use a foreign phrase, a scientific word, or a jargon word if you can think of an everyday English equivalent.%0a\ No newline at end of file%0a host:1597970894=38.81.163.143 author:1597970360=jrmu diff:1597970360:1597970360:=1,9d0%0a%3c # Talk like a normal human being, not an academic.%0a%3c # Never use the word '''one''' when you mean '''you''':%0a%3c # '''Wrong''': One should install the package by running $ doas pkg_add tcl%0a%3c # @@$ doas pkg_add tcl@@%0a%3c # Never use a long word where a short one will do.%0a%3c # If it is possible to cut a word out, always cut it out.%0a%3c # '''Wrong''': %0a%3c # Never use the passive where you can use the active.%0a%3c # Never use a foreign phrase, a scientific word, or a jargon word if you can think of an everyday English equivalent.%0a\ No newline at end of file%0a host:1597970360=38.81.163.143