STEP:Guide-Development Workflow: Difference between revisions

From Step Mods | Change The Game
mNo edit summary
Line 38: Line 38:


== Release Checklist ==
== Release Checklist ==
=== Forum Pre-release Checklist ===
# Check, double-check, and finalize the Dev Changelog
# Close old '''Feedback & Bug Reports''' topic, unpin and lock it
# Complete a final edit to Dev Mod List ensuring it matches the Dev Changelog
# Start new '''Feedback & Bug Reports''' topic, pin it (edit accordingly to point to new release changelog)
## Enter the '''GameName DEV''' version in the first textbox and click the '''Edit Existing''' button
# Close old Dev topics found with the guide's Administration forum and start new one (edit accordingly to point to new Dev Changelog, pin/unpin accordingly)
##: [[File:Create or Edit ModList.PNG|500px|frameless|border]]
# Post new Release announcement topic in the Announcement forum and pin it
## 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
# Unpin and lock the previous release's announcement topic in the Announcement forum
# 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
=== Wiki Pre-release Checklist ===
## Update the Nexus changelog with the appropriate information
# Check, double-check, and finalize the Dev Changelog!!!
## Update Credit section, if applicable
# Complete a final edit to Dev Mod List ensuring it matches the Dev Changelog by entering the '''GameName DEV''' version in the first textbox and clicking the '''Edit Existing''' button
## Upload any new files to Nexus, replacing the previous ones using the same naming scheme
#: [[File:Create or Edit ModList.PNG|500px|frameless|border]]
## Leave the Nexus page open for later steps
 
# On the Step forums
=== Nexus Pre-release Checklist ===
## Close the previous release's '''Feedback & Bug Reports''' topic, unpin and lock it
# Hide the Nexus page, giving a description that an update is underway
## Create a new '''Feedback & Bug Reports''' topic, pin it (edit the links accordingly)
# Update the Changelog with the appropriate information
## Close old Dev topics found with the guide's Administration forum and start new one (edit, pin/unpin accordingly)
# Upload any new files, replacing the previous ones
# Revisit the Modding Guide's Nexus page
# Edit the Nexus description using the '''BBCode''' view and update all current version and changelog version links
## 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

Revision as of 06:09, September 29, 2023

Delta c.png

Step Guide-Developmental Workflow

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

by: Step Modifications  | Forum Topic

The Developmental Workflow is the process used for all of the Modding Guide development cycles. Within each workflow section is a Pre-release Checklist that much be completed directly prior to releasing a new Modding Guide version.

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 Workflow[edit | edit source]

Guide Propagation[edit | edit source]

Unless the Modding Guide is new, the Dev version should already exist from previous releases.

  1. Ensure the GameName DEV version corresponds to the actual 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 current dev release number for the respective Modding Guide. Change NOTHING else at this point!
  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 GameName DEV version into the second textbox and click the Propagate button.
    Create or Edit ModList.PNG

Mod Pages[edit | edit source]

  1. Create mod pages for all new ACCEPTED mods, if they do not exist
  2. Ensure new mod pages are complete with the correct flags and instructions present
  3. Ensure mods that were moved to new categories have had their mod category changed on their mod page

Forum Workflow[edit | edit source]

  1. Ensure all new ACCEPTED topics are named correctly: NexusName (by AuthorName)
  2. Ensure that all new ACCEPTED topic OPs are formatted with the correct mod topic header
    Ckeditor-modtopic.JPG
  3. 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
  4. Ensure all mods that were dropped from a Guide have been prefixed as DROPPED and their ACCEPTED prefix/tags removed

Nexus Workflow[edit | edit source]

Unless the Modding Guide is new, the Nexus page should already exist.

Release Checklist[edit | edit source]

  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