User:Soloblast/Writing Guide

< User:Soloblast
Revision as of 14:51, 14 October 2017 by Soloblast (talk | contribs) (Better structure(?))

Introduction

Aims

The aim of this (working) paper/guide are as follows:

  • To provide guidance for editors in developing good writing skills while avoiding common mistakes.
  • To establish a consistent series of terms/abbreviations/nomenclature to be used.
  • To discuss the overall work processes involved in the Wiki, along with how and where editing/writing fits into these processes.
    • (TBC - Discussion of Translation vis-à-vis Editing/Writing?)

Why Now?

I actually have a day job now, so I anticipate becoming very busy in the near future, for an indeterminate period of time.

As with the Wiki, the volume of work involved may ebb and flow according to the different times of the year, but I figured that I might as well get this out there and ready for consumption (or for someone to take over writing in the future) before I get overwhelmed. (Insert something about giving a man a fish versus teaching a man to fish here.)

My job involves a metric ton of writing/editing/redoing-both-of-the-above as it is, so many of the skills are transferable to doing something like this anyway (and vice versa). Just remember: Those who can, do; those who can't, teach; and those who can't teach, teach teachers. :^)

How To Use This Guide

By the time it is completed, this guide will probably be relatively long. Don't try to read it all in one go!

Instead, you should probably look for specific sections of it that are most relevant to whatever issue you are facing at the moment. Also, while I will do / have done my best to make this guide as comprehensive as possible, there is no way for me to cover all the bases. As always, if unsure, ask on IRC/Discord before committing to any changes / final drafts. This is very important; a mistake could end up screwing someone else over - or worse, players who just copy-paste things without thinking - very easily.

On Writing

On Terms, Abbreviations, And So On

On Work Processes

Expected Annual Events

(Placeholder Text - This section should cover in-game events only, although it may be necessary to include IRL events that have been known to release information relevant to in-game events.)

The annual cycle for KanColle events is roughly as follows (not including new events and/or unexpected developments):

  • Placeholder Text

"Peak" Times and "Off-Peak" Times

Within this annual cycle, there are both "Peak" and "Off-Peak" periods (and yes, I just made that distinction up right now). "Peak" times are time-frames when you should expect to be busy with information collection, collation, analysis, and dissemination; "Off-Peak" times are everything else.

Generally speaking, Peak times take place during most if not all annual events, as well as during the immediate aftermath of a maintenance/update (especially if said maintenance/update introduces new mechanics and/or new remodels). You should expect to need to get a lot of work done, very quickly, but also without compromising on the accuracy or reliability of said information.

Off-Peak times are a lot more of a grey area in that, well, not a lot actually gets done during these periods, but there are always things that need fixing: Outdated information, misnamed file uploads, poor grammar/wording, and so on. (Speaking of which, if anyone is willing to autistically hunt down each and every one of these errors and compile them into a nice list for everyone to reference, by all means, go ahead.)

Useful References/Texts

  • Gowers, Ernest. Plain Words: A Guide to the Use of English. 1954. Edited by Rebecca Gowers, Penguin UK, 2015.
  • Scarlet, Remi. Guide:Translations.