STEP:Guide-Development Workflow: Difference between revisions

From Step Mods | Change The Game
No edit summary
Line 1: Line 1:
__NOTITLE__[[Category:Administration]][[Category:Reference]][[Category:How-To Guides]]{{PageTitle|logo=delta|title=Guide-Development Workflow|subtitle=A high-level overview of community-driven guide ideation/creation|author=Step Modifications|forumtid=4933}}{{TOC right}}
__NOTITLE__[[Category:Administration]][[Category:Reference]][[Category:How-To Guides]]{{PageTitle|logo=delta|title=Guide-Development Workflow|subtitle=A high-level overview of community-driven guide ideation/creation|author=Step Modifications|forumtid=4933}}{{TOC right}}
 
=== Workflow Overview ===
The Step forums serve as one component of release development for mod-build guides. Any registered members may post a new topic in one of the ''<GameName> Mods'' forums within our [https://stepmodifications.org/forum/forum/149-supported-games/ Supported Games] forums. These mod topics serve as the "catch-all" for information and feedback relating to the any specific mod. Mods being actively considered for one of the official mod-build guides will be prefixed with a yellow "{{fc|yellow|Testing}}" tag and tagged with the '[[Property:ModGroup|ModGroup]]' corresponding to the wiki mod page. These mods can be filtered by clicking on the tag itself. All testing feedback is done on the individual topic for that specific mod. If a given mod "passes" testing, then its topic will be prefix-tagged "{{fc|green|Accepted}}". The corresponding wiki mod pages directly feed information into guide ModGroup tables via the [[STEP:Mod-Build_Guide_Framework|custom framework]].
The Step forums serve as one component of release development for mod-build guides. Any registered members may post a new topic in one of the ''<GameName> Mods'' forums within our [https://stepmodifications.org/forum/forum/149-supported-games/ Supported Games] forums. These mod topics serve as the "catch-all" for information and feedback relating to the any specific mod. Mods being actively considered for one of the official mod-build guides will be prefixed with a yellow "{{fc|yellow|Testing}}" tag and tagged with the '[[Property:ModGroup|ModGroup]]' corresponding to the wiki mod page. These mods can be filtered by clicking on the tag itself. All testing feedback is done on the individual topic for that specific mod. If a given mod "passes" testing, then its topic will be prefix-tagged "{{fc|green|Accepted}}". The corresponding wiki mod pages directly feed information into guide ModGroup tables via the [[STEP:Mod-Build_Guide_Framework|custom framework]].



Revision as of 17:31, June 24, 2021

Delta c.png

Guide-Development Workflow

A high-level overview of community-driven guide ideation/creation

by: Step Modifications  | Forum Topic

Template:TOC right

Workflow Overview

The Step forums serve as one component of release development for mod-build guides. Any registered members may post a new topic in one of the <GameName> Mods forums within our Supported Games forums. These mod topics serve as the "catch-all" for information and feedback relating to the any specific mod. Mods being actively considered for one of the official mod-build guides will be prefixed with a yellow "Testing" tag and tagged with the 'ModGroup' corresponding to the wiki mod page. These mods can be filtered by clicking on the tag itself. All testing feedback is done on the individual topic for that specific mod. If a given mod "passes" testing, then its topic will be prefix-tagged "Accepted". The corresponding wiki mod pages directly feed information into guide ModGroup tables via the custom framework.

In order for the mod-build guides to remain relevant, it is imperative that this generalized workflow be maintained by staff, guide Curators, and community contributors. Certain parts of the current workflow are restricted to Administrators, Step Admin, Step Curators, and guide Curators; however, most of the workflow is exposed to all community members. It's this functionality that is presented here along with a breakdown of the update workflow. It's important that the community help drive the process, because it takes a lot of time to maintain the entire workflow and all of the quality assurance that goes along with it.

Please see our Member Groups as a reference for the member roles mentioned in this article.

Mod Topics

  1. Community Members post topics on the {Gamename} Mods forums according to the posting guidelines.
    • This is a continuous process, and many mods topics currently exist on the forums, so please search before posting!
    • Any mod can be posted in mod topics, but they must quality thresholds in order to be considered for mod-build guides.
    • These threads contain community feedback pertaining to the mod.
  2. Community Members post on the current release vx.x.x Development Thread, calling out specific mods in MS that are particularly "hot" for STEP inclusion. These mods should be fairly well researched by the poster.
    • Anyone posting in the Development Thread should be prepared to act as Mod Testers for any mods being advocated or disavowed. ALL Members can act as mod testers. These members will be credited accordingly for their work within the STEP Guide for that release.
  3. Administrators or STEP Staff determine which mods in the Mods forum will be called out for testing based largely on mods called out by Members on the Development Thread.
    • Administrators or STEP Staff will tag these mods for Testing by appending the [ TESTING ] tag
    • Knowledgeable community members will post some minimum criteria for testing, and Moderators, Super Moderators, STEP Staff or Administrators will update the testing topic's OP. It is expected that the community provide the mod testing detail that is requested in the OP (particularly the Development Thread advocates). A mod will remain in the testing phase until the minimum testing criteria have been met.
  4. Once adequately "tested", mods under testing will be either tagged as [ ACCEPTED ] OR moved back into the Mods forum.
    • [ ACCEPTED ] mods:
      • Mod Testers or other advocates of accepted mods must CREATE THE CORRESPONDING MOD PAGE on the STEP Wiki PRIOR TO RELEASE. Moderators, Administrators, or STEP Staff will update the OP and the wiki mod page with these notes. NOTE: Mod pages must also be created if they do not already exist for inclusion into any Pack.
      • Mod Testers or other advocates of accepted mods must specify any pertinent installation notes pertaining to the mod ON THE MOD'S TOPIC. PRIOR TO RELEASE.
      • Administrators or STEP Staff will move accepted mods into the STEP Mod Anthology on the release date (the original Mod topic redirect will remain and point now to the Anthology).
    • All threads, regardless of acceptance into STEP, will continue to be used for posting as per usual, since the Mods forum should, theoretically, house all mod topics.

Once mods are accepted and the corresponding mod pages created, Administrators and STEP Staff 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 senior staff's time, therefore, we ask that the community help out by supplying the needed information and contributing to site maintenance wherever possible.

Thanks!