News Feed
Sections




News Archive
Looking for more information on how to do PHP the right way? Check out PHP: The Right Way

SitePoint.com:
Best Practice for Code Examples
August 14, 2013 @ 10:29:55

If you've ever thought about including code examples in your (blog/site/etc) posts and were wondering how to least frustrate your site's visitors, check out these suggestions from one of SitePoint's UX authors, James Edwards.

The majority of articles about web development include code examples, and across the web we see great variation in how they're formatted and presented. But a lot of them are not very good - because the code is badly formatted, hard to read, or can't be copied-and-pasted without unwanted junk. So in this article I'd like to take a hard look at code examples, to investigate the common problems they have, and try to establish some best practice for how they should be done.

He talks first about the whole point of including code examples in a post and five basic principles for what they should be like:

  • Code examples should use good semantic markup.
  • Tabs in code should not be converted to spaces.
  • Code should have basic syntax highlighting.
  • Code examples can have horizontal scrolling, but shouldn't have vertical scrolling.
  • Code examples should have line numbers, which are not included in text selection.

There's some examples of code markup included as well as some CSS rules you can drop in to help follow his suggestions.

0 comments voice your opinion now!
bestpractice code sample ux example

Link: http://www.sitepoint.com/best-practice-for-code-examples

blog comments powered by Disqus

Similar Posts

Terry Chay's Blog: Clever HTTP

NetTuts.com: Refactoring Legacy Code: Part 8 - Inverting Dependencies for a Clean Architecture

Zend Developer Zone: Pro PHP XML and Web Services Sample Chapter

MySQL Performance Blog: Integers in PHP, running with scissors, and portability

Cocoliso's Blog: Adding A Syntax Highlighter To Your Site: The Power Of Geshi


Community Events





Don't see your event here?
Let us know!


laravel list developer library interview podcast community tips series introduction release bugfix conference symfony api deployment framework language voicesoftheelephpant zendserver

All content copyright, 2014 PHPDeveloper.org :: info@phpdeveloper.org - Powered by the Solar PHP Framework