[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Last revisionBoth sides next revision
slackdocs:styleguide [2012/09/05 23:46 (UTC)] – [Translating a Page] redirected install link to community page mfillpotslackdocs:styleguide [2012/09/08 03:24 (UTC)] – [A General Note on Style] added external definition of "foo" nocturnal.slacker
Line 99: Line 99:
   * If your text has examples of key presses, use the %%<key></key>%% markup to make a visual impact. <key>Alt-F2</key> looks better than "''Alt-F2''".   * If your text has examples of key presses, use the %%<key></key>%% markup to make a visual impact. <key>Alt-F2</key> looks better than "''Alt-F2''".
   * Avoid the passive voice. Use it only when alternatives would be clumsy.   * Avoid the passive voice. Use it only when alternatives would be clumsy.
-  * Try to avoid long-windedness. "To do x, use the -y option" or "To do x, type foo -y" reads better than "If you want foo to do x for you, you need to type foo -y".+  * Try to avoid long-windedness. "To do x, use the -y option" or "To do x, type [[http://www.techopedia.com/definition/7264/foo|foo]] -y" reads better than "If you want foo to do x for you, you need to type foo -y".
  
  
 slackdocs:styleguide ()