Difference between revisions of "Template:Editnotices/Page/Module:Asbox"

From blackwiki
Jump to navigation Jump to search
imported>Codehydro
m (copyedit)
imported>Codehydro
(save... still working on this...)
Line 3: Line 3:
 
|header = Attention
 
|header = Attention
 
|headerstyle = font-size:150%
 
|headerstyle = font-size:150%
|text =  This module behaves differently depending on namespace and whether it is on a subpage. Do not rely on [[Template:Asbox/testcases]] (which is in template space and a subpage) since emulations of template/article space may not fully capture non-template and non-subpage behavior.
+
|text =  This module's behavior depends on namespace and whether or not it is on a subpage. Do not rely on [[Template:Asbox/testcases]] (which is in template space and a subpage) since emulations of template/article space may not fully capture non-template and non-subpage behavior.
  
Unless you're fixing a typo, you should perform all of the following steps before make a live edit (or make a request on the talk page for someone else to review). While tedious, they are essential since the module is live on approximately 2 million pages, such that even a tiny oversight may cause massive miscategorization.
+
Unless fixing a typo, you should perform all of the following sequentially before make a live edit (or make a request help at talk page). While tedious, the module affects approximately 2 million pages, such that even a tiny oversight may cause massive miscategorization.
# Make sure you are previewing in [[Module:Asbox/sandbox]] to avoid accidentally clicking 'save page' instead of 'preview'.
+
 
 +
'''Pre-save checks:'''
 +
# Sync [[Module:Asbox/sandbox]] to current [[Module:Asbox]] and edit there to avoid accidental 'save page' clicks.
 
# Check if [[Template:Asbox/sandbox]] is invoking [[Module:Asbox/sandbox]]. (Sometimes it is set to the pre-module version of Asbox during tests)
 
# Check if [[Template:Asbox/sandbox]] is invoking [[Module:Asbox/sandbox]]. (Sometimes it is set to the pre-module version of Asbox during tests)
# Preview [[Template:Asbox/testcases]] and review each item to ensure inconsistencies, if any, are intentional.
+
# Enter [[Template:Asbox/testcases]] in the box under 'Preview page with this module' (below edit summary). Review each testcase.
# Open in new tab and preview [[User:Codehydro/Asbox userspace testcase]]. Compare preview and live versions of each item.
+
# Open [[User:Codehydro/Asbox userspace testcase]] new tab and use in preview box. Compare preview and live versions.
# Don't forget to check categorization on the bottom of the live and preview versions of page to ensure they match, or that any inconsistencies are expected.
+
# Don't forget to check categorization on the bottom of both the live and preview for inconsistencies
# Repeat the previous two steps on [[Template:Stub]], which is the root stub template (any errors on this template may cascade to all stubs)
+
# Repeat last two steps on [[Template:Stub]], which is the root stub template (any errors there may cascade to all stub templates via [[Module:Asbox stubtree]])
# Repeat both steps on at least one [[Category:Top-level stub categories|top-level]] stub template (e.g. {{t|Geography-stub}})
+
# Repeat both steps on at least one [[:Category:Top-level stub categories|top-level]] template (e.g. {{t|Geography-stub}}). Keep non-preview tab open for follow up.
# Repeat both steps of the last step on a live page that trancludes that template (e.g. any page in [[Category:Geography_stubs]])
+
# Repeat both steps of the last step on a live page that trancludes it (e.g. any page in [[:Category:Geography_stubs]]) Again, keep tab open for follow up.
# Repeat both steps on at least one subordinate stub template (e.g. {{t|Østfold-geo-stub}}) and on a live page that transcludes it.
+
# Repeat both steps on at least one of its subordinate templates (e.g. {{t|Østfold-geo-stub}}) and on a live page that transcludes the subordinate. Keep open.
# Considering repeating all of the above steps. This time, try to find a different top-level and subordinate template.
+
# Consider repeating all of the above steps. When you get back to the final steps, try different top-level and subordinate templates.
# Copy your code to the non-sandboxed version and click 'show changes' and review each change before saving.
+
# Copy sandbox to module and click '''show changes''' and review.
# Remember to perform follow-up actions (below) after the edit.
+
# Before saving, open a tab for [[Template:Editnotices/Page/Module:Asbox]] and proceeed post-save follow-up.
 +
 
 +
'''Post-save follow-up:'''
 +
# Find the tab with top-level template. Make a second tab to the same template.
 +
# Perform a [[null edit]] on the second tab and compare this tab with the pre-save tab.
 +
# See if both pre and post-save tabs have the same categories at the bottom. As a top-level stub, both tabs should '''not''' be categorized under [[:Category:Stub message templates needing attention]].
 +
# If all is well, you may close tabs and repeat previous three steps for the article which trancludes that top-level template.
 +
# Repeat last four steps for the subordinate template.
 +
# Open [{{#invoke:Asbox\testedit|article}} Asbox article test], which is pre-populated with some code.
 +
# Click '''preview''' (do not save).
 +
 
  
Follow-up actions:
+
<!---
# Open a live article that transcludes a top-level stub template and, in another tab, open [[:Category:Stub message templates needing attention]] and check that the article page is not listed.
+
# '''Preview''' the page with <code><nowiki>{{#invoke|Asbox|main}}</nowiki></code>. There should
# If listed, fix problem and look for a live article with a top-level {{t|stub}} that is not already in the attention category. Keep both tabs open.
 
# Open a third tab that is a duplicate of the article and perform a [[null edit]] on this tab.  (Purging is not enough; make sure not to refresh the first tab)
 
# Purge the attention category and make sure the article doesn't appear. If it does, fix the problem.
 
 
# Find a new page near the bottom of [[Special:NewPages]] that is a stub but does not have a stub tag. (Pick one not edited within an hour to avoid edit conflicts)
 
# Find a new page near the bottom of [[Special:NewPages]] that is a stub but does not have a stub tag. (Pick one not edited within an hour to avoid edit conflicts)
# Add <code><nowiki><!--start test of stub maintenance categories; will fix shortly-->{{#invoke|Asbox|main}}<!--end test--></nowiki></code> to new article.
+
# Edit new article and '''preview'''it with .
# Check attention category. Page should appear there.<br>{{*}} If it does not appear, perform a [[null edit]] on the article, purge the category, and check again. If it still does not appear, undo the test edit and check module code.<br>{{*}} If it does appear, replace with appropriate subordinate stub tag.
+
# Look at the bottom of the preview. You should NOT see [[:Category:Stub message templates needing attention]] or any other stub error categories for that matter. Stub maintenance cats should never contain articles; only on the stub template
 +
# Open a tab for  and you should '''not''' find the new page listed there despite the multiple errors (attention tags should never appear in article space). If you do, revert edits to both article and module immediately. Do not proceed to next step.
 +
#
 +
(multiple time as there will be multiple errors). Null edit article or purge category as necessary.<br>{{*}}If you do not find it there, stop and revert your edits to both article and the module immediately. Pay close attenti
 +
 
 +
 
 +
#
 +
, in another tab, open the stub category for that template.
 +
# If listed, fix problem and look for a live article with a top-level {{t|stub}} that is not already in the attention category. Keep both open.
 +
# Open third tab duplicating the article (for a total of two tabs for same article).
 +
# Perform a [[null edit]] on second tab of same article (purging is not enough). Compare before/after null edit tabs.
 +
# Purge attention category and make sure article doesn't appear. If it does, fix the problem. (Assuming no errors in top-level stub template)
 +
 
 +
 
 +
# Page ''should'' appear in attention cat due to lack of required params.<br>{{*}} If it does not appear, [[null edit]] new article, purge category, and recheck. If still missing, undo edits on both article and module.<br>
 +
# Review attention category to see if page is still there with the correct tag. If is there after a purge/null edit, undo module edit and try again.
 
# Remember to revisit the attention category over next few days to ensure no correct pages appear there.
 
# Remember to revisit the attention category over next few days to ensure no correct pages appear there.
  
 
Thank you for your contribution! —[[User:Codehydro|<font color="#aaaaaa" face="Unicode" style="font-size:12pt;">'''Code'''</font>]][[User talk:Codehydro|<font color="#5577aa">'''Hydro'''</font>]] 18:45, 8 February 2015 (UTC)
 
Thank you for your contribution! —[[User:Codehydro|<font color="#aaaaaa" face="Unicode" style="font-size:12pt;">'''Code'''</font>]][[User talk:Codehydro|<font color="#5577aa">'''Hydro'''</font>]] 18:45, 8 February 2015 (UTC)
 
}}
 
}}

Revision as of 21:24, 8 February 2015

{{editnotice |expiry = indefinite |header = Attention |headerstyle = font-size:150% |text = This module's behavior depends on namespace and whether or not it is on a subpage. Do not rely on Template:Asbox/testcases (which is in template space and a subpage) since emulations of template/article space may not fully capture non-template and non-subpage behavior.

Unless fixing a typo, you should perform all of the following sequentially before make a live edit (or make a request help at talk page). While tedious, the module affects approximately 2 million pages, such that even a tiny oversight may cause massive miscategorization.

Pre-save checks:

  1. Sync Module:Asbox/sandbox to current Module:Asbox and edit there to avoid accidental 'save page' clicks.
  2. Check if Template:Asbox/sandbox is invoking Module:Asbox/sandbox. (Sometimes it is set to the pre-module version of Asbox during tests)
  3. Enter Template:Asbox/testcases in the box under 'Preview page with this module' (below edit summary). Review each testcase.
  4. Open User:Codehydro/Asbox userspace testcase new tab and use in preview box. Compare preview and live versions.
  5. Don't forget to check categorization on the bottom of both the live and preview for inconsistencies
  6. Repeat last two steps on Template:Stub, which is the root stub template (any errors there may cascade to all stub templates via Module:Asbox stubtree)
  7. Repeat both steps on at least one top-level template (e.g. Template:T). Keep non-preview tab open for follow up.
  8. Repeat both steps of the last step on a live page that trancludes it (e.g. any page in Category:Geography_stubs) Again, keep tab open for follow up.
  9. Repeat both steps on at least one of its subordinate templates (e.g. Template:T) and on a live page that transcludes the subordinate. Keep open.
  10. Consider repeating all of the above steps. When you get back to the final steps, try different top-level and subordinate templates.
  11. Copy sandbox to module and click show changes and review.
  12. Before saving, open a tab for Template:Editnotices/Page/Module:Asbox and proceeed post-save follow-up.

Post-save follow-up:

  1. Find the tab with top-level template. Make a second tab to the same template.
  2. Perform a null edit on the second tab and compare this tab with the pre-save tab.
  3. See if both pre and post-save tabs have the same categories at the bottom. As a top-level stub, both tabs should not be categorized under Category:Stub message templates needing attention.
  4. If all is well, you may close tabs and repeat previous three steps for the article which trancludes that top-level template.
  5. Repeat last four steps for the subordinate template.
  6. Open [Script error: No such module "Asbox\testedit". Asbox article test], which is pre-populated with some code.
  7. Click preview (do not save).