STEP:Guide-Development Workflow: Difference between revisions

From Step Mods | Change The Game
No edit summary
 
(150 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTITLE____NOTOC__[[Category:Step Guides]]{{PageTitle|logo=delta|title=Step Guide-Development Process|subtitle=A high-level overview of Step Modifications' Modding Guide development process|author=Step Modifications|forumtid=4933}}
== STEP Community Member Roles ==
STEP is a community-driven project. This means that the community at large is the mechanism by which STEP evolves. There are several "levels" of voluntary STEP-community membership:
* <span style="font-weight:bold; color:#FFA800;">Administrators</span> - STEP website maintenance and update management
* <span style="font-weight:bold; color:#F9C;">Anthologists</span> - Senior community members trusted with maintaining the STEP Mandate
* <span style="font-weight:bold; color:#0FA;">Developers</span> - Users assisting on particular development projects relating to STEP or the STEP websites
* <span style="font-weight:bold; color:#DDD;">Editors</span> - These users have special wiki privileges
* <span style="font-weight:bold; color:#70E2FF;">Members</span> - Registered site users
* <span style="font-weight:bold; color:#9ACD32;">Mod Testers</span> - Committed to testing and/or validating at least one mod per STEP release
* <span style="font-weight:bold; color:#FFD700;">Mod Authors</span> - Members that are authors of any Skyrim mod
* <span style="font-weight:bold; color:#D4A1F7;">Moderators</span> - Site moderation and general administrative assistance
* <span style="font-weight:bold; color:#E8B080;">Site Founders</span> - Members of the original founding group of the STEP Community no longer active on the project


== STEP Development ==
The Development Process is used for all Modding Guide development cycles. This process includes on-going maintenance tasks, as well as, release and post-release procedures; which are covered below. Each Modding Guide can be a little unique so not all guides may use everything described.
=== Synopsis ===
The STEP forums serve as the vehicle for STEP release development. Any registered site members may post a new thread in the [http://forum.step-project.com/forumdisplay.php?fid=43 Mod Suggestions (MS) Forum] (posting instructions are displayed on the forum). These threads serve as the "catch-all" for information and feedback relating to the mod. Mods being actively considered for STEP will be stickied within the MS Forum. If a given mod "passes", then its MS thread will be moved to the [http://forum.step-project.com/forumdisplay.php?fid=9 STEP Anthology Forum]. Each mod within the Anthology also has a corresponding STEP Wiki Page. The wiki pages directly feed the official STEP Guide via our custom Semantic Mediawiki infrastructure.


Thus, in order for the STEP Guide to remain current, it is imperative that this generalized workflow be maintained by the community. Certain parts of the current workflow are restricted to {{Fc|#FFA800|Administrators}}; however, most of the workflow is exposed to community Members. It is this functionality that is presented here along with the linear breakdown of the update workflow. Given that STEP is currently on a biweekly release schedule, it is important that the community help drive the process, as a few part-time administrators cannot maintain the entire workflow and all of the quality assurance that goes along with it.
{{Alert|type=notice|text='''Notice to Staff'''<br>In order for Game Guides to remain relevant, it is imperative that this generalized workflow be maintained by staff, Curators, and community contributors.<br><br>''This workflow assumes the corresponding Development Guide and Mod List have already been propagated, which are covered in [[STEP:Mod-Build_Guide_Framework#Step_4:_Create.2FUpdate_ModList|Step 4]] and [[STEP:Mod-Build_Guide_Framework#Step_5:_Propagate_Guide.2FChangelog|Step 5]] of the Mod-Build Guide Framework article.''}}


=== Workflow Details ===
== Wiki Maintenance ==
# <span style="font-weight:bold; color:#e6b69e;">Community {{Fc|#70E2FF|Members}} post threads on the [http://forum.step-project.com/forumdisplay.php?fid=43 Mod Suggestions (MS) Forum] according to the posting guidelines.</span>
The below is the general maintenance for the wiki that takes place throughout the development process.
#* This is a continuous process, and many mods currently exist in MS, so please search before posting!
#* Any mod can be posted in MS, but they must be of sufficient quality in order to be considered for STEP.
#* These threads contain community feedback pertaining to the mod.
# <span style="font-weight:bold; color:#e6b69e;">Community {{Fc|#70E2FF|Members}} post on the current release [http://forum.step-project.com/forumdisplay.php?fid=73 Development Thread], calling out specific mods in MS that are particularly "hot" for STEP inclusion.</span>
#* These mods should be fairly well researched by the poster.
#* Anyone posting in the Development Thread should be prepared to act as {{Fc|#9ACD32|Mod Testers}} for any mods being advocated or disavowed.
# <span style="font-weight:bold; color:#e6b69e;">{{Fc|#FFA800|Administrators}} determine which mods in MS will be called out for testing based largely on mods called out by members on the Devel Thread.</span>
#* {{Fc|#FFA800|Administrators}} or {{Fc|#F9C|Anthologists}}  will sticky these mods in MS, appending the '''[ TESTING ]''' tag
#* Knowledgeable community members will post some minimum criteria for testing on each testing thread OP.
#* It is expected that the community provide the mod testing detail that is requested in the OP (particularly the Devel Thread advocates).
#* A mod will remain in the testing phase until the minimum testing criteria have been met.
# <span style="font-weight:bold; color:#e6b69e;">Once adequately "tested", mods under testing in MS will be tagged as either <span style="color:#00FF99">[ ACCEPTED ]</span> or <span style="color:#ff7730;">[ DENIED ]</span>.</span>
#* Once tagged, each mod thread will remain stickied under MS until the scheduled release date.
#* {{Fc|#9ACD32|Mod Testers}} or other advocates of <span style="color:#00FF99"><b>[ ACCEPTED ]</b></span> mods must [[STEP:Main|'''CREATE THE CORRESPONDING MOD PAGE''']] on the STEP Wiki PRIOR TO RELEASE.
#* {{Fc|#FFA800|Administrators}} or {{Fc|#F9C|Anthologists}} will move mods that have completed testing either to the STEP Anthology or back into the general MS thread pool, depending on status.
#* These threads will continue to be used for posting as per usual.


Once Mods are accepted and the corresponding mod pages created, {{Fc|#FFA800|Administrators}} or {{Fc|#DDD|Editors}} are able to incorporate new mods into the current STEP Development Guide. Workflow-related activities combined with site & workflow maintenance, Guide upkeep, and Nexus upkeep require almost all of the {{Fc|#FFA800|Administrators'}} time, therefore, we ask that the community help out by supplying the needed information and contributing to site maintenance wherever possible.
=== Changing Dev Version Post Propagation ===
Unless the Modding Guide is new, the Dev version typically already exists from previous releases. In the rare event a Dev Guide changes versioning during the course of development due to more extensive changes than initially planned (e.g, ''Dev v2.7'' becomes ''Dev v3.0'' ), then the following is how to update the versioning mid-development:


Thanks!
WIP


=== Mod Pages ===
* Create mod pages for all new {{fc|green|text=ACCEPTED}} mods
* Ensure new mod pages are complete with version-specific pages created, flags set, and correct guide-related instructions
* Ensure mods that were moved to new Mod Groups have had their Mod Group changed on their mod page


== Forum Maintenance==
The below is the general maintenance for the forums that takes place throughout the development process.
* Ensure all new {{fc|green|ACCEPTED}} topics are named correctly: <code>NexusName (by AuthorName)</code>
* Ensure all new {{fc|green|ACCEPTED}} topic OPs are formatted with the correct mod topic header
*: [[File:Ckeditor-modtopic.JPG|600px|frameless|border]]
* Ensure the {{fc|yellow|TESTING}} prefix has been removed from all new {{fc|green|ACCEPTED}} mods. Mods not accepted can keep their {{fc|yellow|TESTING}} prefix, if testing is planned to continue for the next release; else, the prefix should be removed.
*# From the Topic view, tick the box at right of the {{fc|green|ACCEPTED}} topic
*# Select '''Unmark for Testing''' from the menu in the tool pop-up at lower right
* Ensure all mods that were dropped from a Guide have been prefixed as {{fc|red|DROPPED}} and their {{fc|green|ACCEPTED}} prefix/tags removed


== Nexus Maintenance ==
Unless the Modding Guide is new, the Nexus page should already exist. Since Nexus pages are mainly static, there is no required on-going maintenance.


== Release Procedures ==
The checklist is to be completed in the order listed for every Modding Guide release to ensure a smooth release. Be aware, some of the step are re-verifying general workflow maintenance was completed. Do not skip these steps! They exist for quality assurance purposes.
# Check, double-check, and finalize the Dev Changelog
# Complete a final edit to Dev Mod List ensuring it matches the Dev Changelog
## Enter the '''GameName DEV''' version in the first textbox and click the '''Edit Existing''' button
##: [[File:Create or Edit ModList.PNG|500px|frameless|border]]
## Verify the {{fc|red|DROPPED/REPLACED}} mods have been removed, the {{fc|orange|MOVED}} mods have been relocated in the Mod List, and the newly {{fc|green|ACCEPTED}} mods have been added
# Visit the Modding Guide's Nexus page
## Hide the Nexus page, providing a description that an update is underway and the page will return shortly
## Update the Nexus changelog with the appropriate information
## Update Credit section, if applicable
## Upload any new files to Nexus, replacing the previous ones using the same naming scheme
## Leave the Nexus page open for later steps
# On the Step forums
## Close the previous release's '''Feedback & Bug Reports''' topic, unpin and lock it
## Create a new '''Feedback & Bug Reports''' topic, pin it (edit the links accordingly)
## Close old Dev topics found with the guide's Administration forum and start new one (edit, pin/unpin accordingly)
# Revisit the Modding Guide's Nexus page
## Update the Nexus description using the '''BBCode''' view and revise all guide and changelog links, feedback links, etc.
## Unhide/publish the page
# Return to the forum
## Post a new Release topic in the Announcement forum, feature and pin it
## Unfeature, unpin, and lock the previous release's announcement topic
# Post or request an Admin post an announcement to Step's Facebook page regarding the new guide release


[[Category:Guides]]
== Post-release Procedures ==
=== Guide Propagation ===
# Ensure the '''GameName DEV''' version corresponds to the new development release version! ''{{fc|instruction|If this is not set correctly, then the platform will not behave as expected!}}''
## Open the [[STEP:Main|Step Portal]]
## Edit '''Guide Versioning''' by clicking the '''Create or edit''' button
##: [[File:VersioningUpdate.png|650px|frameless|border]]
## Change the '''GameName DEV''' number to the new dev release number for the respective Modding Guide.
## {{fc|warning|text=''Change NOTHING else! Simply save the page.''}}
# From the Game's Portal, copy new Dev Guide
# From the Game's Portal, copy new Dev Changelog
#: [[File:GamePortalNav.png|140px|frameless|border]] [[File:Propagate_or_Edit_Guide.png|500px|frameless|border]]
# Propagate new a Mod List for the development release by entering the new '''GameName DEV''' version into the second textbox and click the '''Propagate''' button.
#: [[File:Create or Edit ModList.PNG|500px|frameless|border]]

Latest revision as of 15:00, September 29, 2023

Delta c.png

Step Guide-Development Process

A high-level overview of Step Modifications' Modding Guide development process

by: Step Modifications  | Forum Topic

The Development Process is used for all Modding Guide development cycles. This process includes on-going maintenance tasks, as well as, release and post-release procedures; which are covered below. Each Modding Guide can be a little unique so not all guides may use everything described.

Info-Logo.png

NOTE

Notice to Staff
In order for Game Guides to remain relevant, it is imperative that this generalized workflow be maintained by staff, Curators, and community contributors.

This workflow assumes the corresponding Development Guide and Mod List have already been propagated, which are covered in Step 4 and Step 5 of the Mod-Build Guide Framework article.

Wiki Maintenance

The below is the general maintenance for the wiki that takes place throughout the development process.

Changing Dev Version Post Propagation

Unless the Modding Guide is new, the Dev version typically already exists from previous releases. In the rare event a Dev Guide changes versioning during the course of development due to more extensive changes than initially planned (e.g, Dev v2.7 becomes Dev v3.0 ), then the following is how to update the versioning mid-development:

WIP

Mod Pages

  • Create mod pages for all new ACCEPTED mods
  • Ensure new mod pages are complete with version-specific pages created, flags set, and correct guide-related instructions
  • Ensure mods that were moved to new Mod Groups have had their Mod Group changed on their mod page

Forum Maintenance

The below is the general maintenance for the forums that takes place throughout the development process.

  • Ensure all new ACCEPTED topics are named correctly: NexusName (by AuthorName)
  • Ensure all new ACCEPTED topic OPs are formatted with the correct mod topic header
    Ckeditor-modtopic.JPG
  • Ensure the TESTING prefix has been removed from all new ACCEPTED mods. Mods not accepted can keep their TESTING prefix, if testing is planned to continue for the next release; else, the prefix should be removed.
    1. From the Topic view, tick the box at right of the ACCEPTED topic
    2. Select Unmark for Testing from the menu in the tool pop-up at lower right
  • Ensure all mods that were dropped from a Guide have been prefixed as DROPPED and their ACCEPTED prefix/tags removed

Nexus Maintenance

Unless the Modding Guide is new, the Nexus page should already exist. Since Nexus pages are mainly static, there is no required on-going maintenance.

Release Procedures

The checklist is to be completed in the order listed for every Modding Guide release to ensure a smooth release. Be aware, some of the step are re-verifying general workflow maintenance was completed. Do not skip these steps! They exist for quality assurance purposes.

  1. Check, double-check, and finalize the Dev Changelog
  2. Complete a final edit to Dev Mod List ensuring it matches the Dev Changelog
    1. Enter the GameName DEV version in the first textbox and click the Edit Existing button
      Create or Edit ModList.PNG
    2. Verify the DROPPED/REPLACED mods have been removed, the MOVED mods have been relocated in the Mod List, and the newly ACCEPTED mods have been added
  3. Visit the Modding Guide's Nexus page
    1. Hide the Nexus page, providing a description that an update is underway and the page will return shortly
    2. Update the Nexus changelog with the appropriate information
    3. Update Credit section, if applicable
    4. Upload any new files to Nexus, replacing the previous ones using the same naming scheme
    5. Leave the Nexus page open for later steps
  4. On the Step forums
    1. Close the previous release's Feedback & Bug Reports topic, unpin and lock it
    2. Create a new Feedback & Bug Reports topic, pin it (edit the links accordingly)
    3. Close old Dev topics found with the guide's Administration forum and start new one (edit, pin/unpin accordingly)
  5. Revisit the Modding Guide's Nexus page
    1. Update the Nexus description using the BBCode view and revise all guide and changelog links, feedback links, etc.
    2. Unhide/publish the page
  6. Return to the forum
    1. Post a new Release topic in the Announcement forum, feature and pin it
    2. Unfeature, unpin, and lock the previous release's announcement topic
  7. Post or request an Admin post an announcement to Step's Facebook page regarding the new guide release

Post-release Procedures

Guide Propagation

  1. Ensure the GameName DEV version corresponds to the new development release version! If this is not set correctly, then the platform will not behave as expected!
    1. Open the Step Portal
    2. Edit Guide Versioning by clicking the Create or edit button
      VersioningUpdate.png
    3. Change the GameName DEV number to the new dev release number for the respective Modding Guide.
    4. Change NOTHING else! Simply save the page.
  2. From the Game's Portal, copy new Dev Guide
  3. From the Game's Portal, copy new Dev Changelog
    GamePortalNav.png Propagate or Edit Guide.png
  4. Propagate new a Mod List for the development release by entering the new GameName DEV version into the second textbox and click the Propagate button.
    Create or Edit ModList.PNG
Retrieved from "https://stepmodifications.org/wiki/index.php?title=STEP:Guide-Development_Workflow&oldid=187183"