User:Dreftymac/Docs/Howto
< User:Dreftymac | Docs
 | This is an essay. It contains the advice or opinions of one or more Wikipedia contributors. This page is not an encyclopedia article, nor is it one of Wikipedia's policies or guidelines, as it has not been thoroughly vetted by the community. Some essays represent widespread norms; others only represent minority viewpoints. |
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 ...