Help:Add new Honor Variant - Revision history

Jomegat: copy edits

2023-10-04T00:36:46Z

copy edits

DesignerThan at 15:23, 3 October 2023

2023-10-03T15:23:26Z

Jomegat: wordsmithing

2023-07-08T01:39:51Z

wordsmithing

DesignerThan at 15:49, 6 July 2023

2023-07-06T15:49:04Z

DesignerThan at 15:45, 6 July 2023

2023-07-06T15:45:44Z

DesignerThan: DesignerThan moved page AY Honors/Postcards (Other)/Answer Key to Help:Add new Honor Variant without leaving a redirect

2021-07-14T22:45:14Z

DesignerThan moved page AY Honors/Postcards (Other)/Answer Key to Help:Add new Honor Variant without leaving a redirect

DesignerThan at 22:44, 14 July 2021

2021-07-14T22:44:26Z

Jomegat: Created page with "{{HonorSubpage}} You are probably reading this because you did not find your country listed in the Answer Key dropdown menu. You can add your country by following..."

2021-04-10T23:21:43Z

Created page with "{{HonorSubpage}} <translate> You are probably reading this because you did not find your country listed in the Answer Key dropdown menu. You can add your country by following..."

New page

{{HonorSubpage}}
<translate>
You are probably reading this because you did not find your country listed in the Answer Key dropdown menu. You can add your country by following these steps:

#Edit the {{fullurl:AY Honors/Postcards|action=edit}} page by clicking this link (it's best to open this in another tab so you can continue reading these instructions).
#Near the top of the page you should find the list of countries listed as ''answer_variants=...''. Add your country here (please maintain alphabetic ordering). Make sure you do not put a space between the two semicolons (;;) and the country name.
#Save the page, and click the Answer Key dropdown. Your country should appear. Click it.
#This will take you to a non-existant page. Click the ''create page'' link.
#Enter the text below to add all the formatting and requirements:

<nowiki>{{subst::AY Honors/Postcards (Template)/Answer Key}}</nowiki>

#<li value=6>Save the page.
#Open the page for editing again (see the pencil icon at the top right).
#Add your answers below each instance of the ''<nowiki>{{</nowiki>ansreq=...}}'' text between the ''<nowiki><translate></nowiki>'' and ''<nowiki></translate></nowiki>'' tags.
#If you need help drop a note in the [[Talk:AY Honors/Postcards (Other)/Answer Key|discussion page]]. Someone should get back to you in about a day.

</translate>
{{CloseHonorPage}}

@@ Line 9: / Line 9: @@
 ==When to create an honor variant==
-Honor Variants are apply able for honor that have the same name and overall topic but different requirements or need country specific answers. Also honor variants are only allowed for the following instances of the Seventh-Day-Adventist Church:
+Honor Variants are applicable for honors that have the same name and overall topic but different requirements or need country-specific answers. Also, honor variants are only allowed for the following institutions within the Seventh-day Adventist Church:
 * General Conference
 * Divisions
 * Unions
-Before adding a variant to an honor that fits those criteria, consider adopting one of the variants that are already there. It may also be a possibility to discuss the differences at the discussion page of the honor, what may lead to a change of the existing requirements. The NADs Honor Taskforce, which is running this wiki, is open for suggestions on how to improve the existing honors further. You can use this form to reach out to them. It leads you through a process, that helps to specify why it is good to apply the changes suggested.
+Before an institution of the Seventh-day Adventist Church adds a variant to an honor that fits these criteria, it is best to consider adopting one of the variants that are already there. It is also recommended that you open a discussion on the proposed differences on the honor's discussion page, which may lead to an official change of the existing requirements. The NAD's Honor Taskforce, which is running this wiki, is open to suggestions on how to improve the existing honors further. You can use this form to reach out to them. It leads you through a process that helps to specify why it is good to apply the changes suggested.
 If that isn't an option you may add an honor variant.
-It can happen that an honor is named differently but has similar content than an existing honor or that is approved by a church instance not mentioned above. For those cases we have implemented cross-honor-links. For example they are used for the [[AY Honors/ADRA|ADRA-honors]].
+It can happen that an honor is named differently but has similar content than an existing honor or that is approved by a church institution below the Union level. For those cases we have implemented cross-honor-links. For example they are used for the [[AY Honors/ADRA|ADRA-honors]].
-If the honor isn't approved by an instance named above, the crosslink is only allowed to point to the honor of an instance named above and the category of that honor needs to be Regional.
+If the honor isn't approved at the Union level or above, the crosslink may only point from the lower-level version to the higher-level version, and the category of that honor needs to be set to Regional.
 ==How to add Honor Variants==

@@ Line 1: / Line 1: @@
 <translate>
-==How to add Honor Variants==
+==What are Honor Variants==
 Honors are not the same all over the world.  One division may create an honor, and another may create a similar honor with different requirements.  The General Conference may make a third honor by combining the honors from two different divisions, or may adopt a division's honor but edit the requirements.  If the division wishes to keep their original honor as they had written it, this creates two versions of the same honor.
@@ Line 7: / Line 7: @@
 So, honors may have different requirements or different answer keys, and this wiki deals with that by creating honor variants - if the requirements have variants, then the answer keys will too, but it's possible that only the answer key will have a variant.
 Thus, we have two different types of honor variants. Answer Key Variants and Requirement Variants.
 The way of creating them is the same for both.
 # Open the landing page of the honor where you want to add a variant.

@@ Line 1: / Line 1: @@
 <translate>
 ==How to add Honor Variants==
-There are two different types of honor variants. Answer Key Variants and Requirement Variants.
+Honors are not the same all over the world.  One division may create an honor, and another may create a similar honor with different requirements.  The General Conference may make a third honor by combining the honors from two different divisions, or may adopt a division's honor but edit the requirements.  If the division wishes to keep their original honor as they had written it, this creates two versions of the same honor.
 The way of creating them is the same for both.
 # Open the landing page of the honor where you want to add a variant.
 # Go into the Edit view.
-# Add the property with the information of the wanted variant and increment the count of the variants.
+# Add the property with the information of the wanted variant and increment the count of the variants (more on this below).
 # Save the changes. Now the added Variant should appear in the dropdown, over which it is possible to create the needed pages.
 ==Requirement Variant specific information==
-Requirement Variants are used for honors, that have different requirements in different levels of our Organization. For example the North American Division has introduced an honor and later the General Conference adapts it, but changes some requirements, that the NAD doesn't want to use. That is where Requirement Variants come into play.
+Requirement Variants are used for honors that have different requirements in different levels of our organization. For example, the North American Division may introduced an honor, and later the General Conference adopts it, but changes some requirements.  Sometimes the originating division may adopt the GC's changes, but sometimes they may choose not to.  That is where Requirement Variants come into play.
-The are allowed to use for the following Authority Levels:
+This wiki allows variants for the following authority Levels:
 * General Conference
 * Division Level
@@ Line 17: / Line 22: @@
 ===Properties of the Requirement Variant===
-<code>cnt_requirements_variants</code>: This is the count of the Requirement Variants.
+The landing page uses a template that has key/value pairs (each key is assigned a value).  The keys listed below specify requirement variants:
-<code>requirement_n</code>: This is the name of the Variant, it defines which text is used in the tab. You can find the possibilities here: [[Localization:Authorities]]. n needs to be incremented starting at 1.
+*<code>cnt_requirements_variants</code>: This is the total number of Requirement Variants for the honor.
 ==Answer Key Variant specific information==
-Answer Key Variants are needed for two reasons. One are the Requirement Variants and the other are honors that need Country/Region specific answers.
+Answer Key Variants are needed for two reasons. One is because the honor has Requirement Variants and the other is for honors that need Country/Region specific answers.
 ===Properties of the Answer Key Variant===
-<code>cnt_answerKey_variants</code>: This is the count of the Answer Key Variants.
+*<code>cnt_answerKey_variants</code>: This is the total number of the Answer Key Variants for this honor.
-<code>answerKey_n</code>: Here we define the different informations that the Answer Key Variant needs. <code>country1;country2;;number of the requirement variant associated/source language code only needed in special cases</code>
+*<code>answerKey_n</code>: The value assigned to the answerKey_n field has multiple elements, and takes the form <code>country1;country2;;number of the requirement variant associated/source language code only needed in special cases</code>.  The first element is a list of semicolon-separated countries using the variant. The next element is separated by two semicolons and specifies a number identifying which requirement variant is used for this answer key (for instance, answer variant 3 may use requirement variant 2).  The final element of this value is optional and is separated by a <code>/</code>. It indicates the answer key's source language.
-:Here you can find the implemented Countries using the ID as propert. [[Localization:Countries]] Each country ID needs to be separated by a semicolon.
+:You can find the implemented Countries using the ID as property at [[Localization:Countries]]. Each country ID needs to be separated by a semicolon.
 :The number of the Requirement Variant needs to be separated by two semicolons
-:The source language code is only needed if the source language of the answer key page isn't english.
+:When material on the wiki is translated, it has a "source language".  This is usually English, but answer keys can use a different source language (it doesn't make sense to require English as the source language for an answer key targeting a non-English-speaking country).  The source language code is only needed if the source language of the answer key page isn't English.
 ==Examples==
@@ Line 41: / Line 47: @@
 <li>Near the top of the page you should find the list of countries listed as ''answer_variants=...''.  Add your country here (please maintain alphabetic ordering).  Make sure you do not put a space between the two semicolons (;;) and the country name.</li>
 <li>Save the page, and click the Answer Key dropdown.  Your country should appear.  Click it.</li>
-<li>This will take you to a non-existant page.  Click the ''create page'' link.</li>
+<li>This will take you to a non-existent page.  Click the ''create page'' link.</li>
 <li>Enter the text below to add all the formatting and requirements:</li>

@@ Line 37: / Line 37: @@
 ==Additional information==
 You are probably reading this because you did not find your country listed in the Answer Key dropdown menu.  You can add your country by following these steps:
+<ol>
-#Edit the {{fullurl:AY Honors/Postcards|action=edit}} page by clicking this link (it's best to open this in another tab so you can continue reading these instructions).
+<li>Edit the {{fullurl:AY Honors/Postcards|action=edit}} page by clicking this link (it's best to open this in another tab so you can continue reading these instructions).
-#Near the top of the page you should find the list of countries listed as ''answer_variants=...''.  Add your country here (please maintain alphabetic ordering).  Make sure you do not put a space between the two semicolons (;;) and the country name.
+<li>Near the top of the page you should find the list of countries listed as ''answer_variants=...''.  Add your country here (please maintain alphabetic ordering).  Make sure you do not put a space between the two semicolons (;;) and the country name.</li>
-#Save the page, and click the Answer Key dropdown.  Your country should appear.  Click it.
+<li>Save the page, and click the Answer Key dropdown.  Your country should appear.  Click it.</li>
-#This will take you to a non-existant page.  Click the ''create page'' link.
+<li>This will take you to a non-existant page.  Click the ''create page'' link.</li>
-#Enter the text below to add all the formatting and requirements:
+<li>Enter the text below to add all the formatting and requirements:</li>
   <nowiki>{{subst::AY Honors/Postcards (Template)/Answer Key}}</nowiki>
-#<li value=6>Save the page.
+<li value=6>Save the page.</li>
-#Open the page for editing again (see the pencil icon at the top right).
+<li>Open the page for editing again (see the pencil icon at the top right).</li>
-#Add your answers below each instance of the ''<nowiki>{{</nowiki>ansreq=...}}'' text between the ''<nowiki><translate></nowiki>'' and ''<nowiki></translate></nowiki>'' tags.
+<li>Add your answers below each instance of the ''<nowiki>{{</nowiki>ansreq=...}}'' text between the ''<nowiki><translate></li></nowiki>'' and ''<nowiki></translate></nowiki>'' tags.</li>
-#If you need help drop a note in the [[Talk:AY Honors/Postcards (Other)/Answer Key|discussion page]].  Someone should get back to you in about a day.
+<li>If you need help drop a note in the [[Talk:AY Honors/Postcards (Other)/Answer Key|discussion page]].  Someone should get back to you in about a day.</li>
+</ol>
 </translate>