Some articles are routinely edited with "howto" type content that diminishes the professionalism and credibility of encyclopedia articles. Consider some simple changes that can improve the tone and make the article sound less like a walkthrough or a tutorial. Improving the tone and clarity of articles helps make the content accessible to those who may be unfamiliar with the source material, while still providing experienced readers with sufficient context.

Examples

edit
  • how to: you can start the FooShmoo interpreter by ...
  • better: a programmer can start the FooShmoo interpreter by ...

...

  • how to: let's consider a simple FleeBarg example where we use the module to open zaz ...
  • better: the FleeBarg module has four components, the simplest of which is the open zaz...

...

  • how to: the next step is to xyz, then we abc, which completes the Zizmog process
  • better: the Zizmog process consists of xyz, abc, and 123. They enable a researcher to ...