GUIDE Step's Guide-Maintenance Framework

[z929669]

Discussion topic:
Step Guide-Maintenance Framework by Step Modifications
Mod-Build curators can access Step's Guide-Maintenance Framework guide and have discussion on this topic.

---

 

[z929669]

For posterity:

The wiki is basically an editable, structured article (aka 'page') and data repository that maintains semantic relationships among articles and article attributes ... as well as the history of edits made to each article. The data are used in associating mods with modgroups, guides, and games. Maintaining the data relationships with each change to an article in real time is a constant (and often performance-demanding) process. With each edit to a semantic data property (i.e., adding new mods or changing the modGroup of existing mods) and associating them with a guide can have a significant performance impact while all of the semantic data associations are rebuilt, which begins almost immediately after the change.

The cost can be a lack of expected data or failure of a mod or modList form to render completely or increased page load time. A suggested workflow to avoid bottlenecks (and wasting your time) during the data build process:

1. Start with the forum mod topic, since it creates the desired wiki URL link that can be clicked to allow the next step.
2. Create the wiki page.
3. Add the text, {{mod}}, and save the page.
4. Use the page edit button to bring up the mod form to add all required data to the mod page (I need to flag the required fields).
5. Continue adding all mods needed for the guide of interest.
6. Wait 30 minutes.
7. Add the mods to the modList.
8. Load the guide page - this should trigger the recalculation of semantic data referenced by the queries on the guide page, which will appear as a small, animated vertical bar chart at upper right. If it doesn't, try using [...] > Refresh from the top menu. If it's grayed out, try a hard refresh of the page.
9. Wait 30 minutes.
10. Edit the guide (after the edit is saved, the ModGroups should all have the expected mods).

Let me know if this works smoothly or if you find a variant that allows you to be more productive while at the keyboard.