Wiki Page Content

Differences between revisions 3 and 4
Revision 3 as of 2011-01-26 19:48:31
Size: 3224
Editor: SheenaSmith
Comment: minor change for consistency
Revision 4 as of 2011-01-26 20:10:09
Size: 3093
Editor: SheenaSmith
Comment: update contents
Deletions are marked like this. Additions are marked like this.
Line 23: Line 23:
For assistance with editing, saving, or wiki-appropriate markup please see the [[http://wiki.libsdl.org/moin.cgi/SGWikiBasics|Wiki Basics]] Style Guide. For assistance with editing, saving, or wiki-appropriate markup see the [[http://wiki.libsdl.org/moin.cgi/SGWikiBasics|Wiki Basics]] Style Guide.
Line 27: Line 27:
If there are no Code Examples in the section please replace the following with your code:
R
eplace the following with your code:
Line 35: Line 36:
If there are existing examples in the section please add a new code box to the end of the examples section, or add your code to the end of a related group if there are many examples of various types.
 * To add a new code box insert the following into the spot where your example will be located:
Add a new code box with your code to the end of the Code Examples section.
  * If there are many examples of various kinds add your code box to the end of a related group, if any.
'''To add a new code box'''
 . Insert the following into the spot where your example will be located and place your content on the blank line between the markup:
Line 43: Line 46:
 * All content should be added within this markup (on the blank line with the markup above and below your example content).
Line 50: Line 52:
== Reminders == == Resources ==

DRAFT

Style Guide: Code Examples

All API pages in this wiki contain a section for Code Examples. This guide provides instructions for adding your own content to the Code Examples section of these pages.

General Guidelines

The Code Examples section should provide simple examples of real-world applications of the API.

Please post code examples showing how you have used the API that may benefit other users.

  • Do not post anything that you do not have permission to post publicly.
  • Code examples should have adequate comments to make them clear and useful.
  • Please remember to keep it simple and easy to understand.

For assistance with editing, saving, or wiki-appropriate markup see the Wiki Basics Style Guide.

Adding the First Code Example

Replace the following with your code:

  • You can add your code example here

  • Do not change or remove any of the markup immediately above or below that line.

Adding Additional Code Examples

Add a new code box with your code to the end of the Code Examples section.

  • If there are many examples of various kinds add your code box to the end of a related group, if any.

To add a new code box

  • Insert the following into the spot where your example will be located and place your content on the blank line between the markup:
    • {{{#!highlight cpp
       
      }}}
    • Example: SDL_Init()

Return to Table of Contents


Resources

Our goal is to create accurate, consistent, helpful, user-friendly documentation. We appreciate your efforts to make your additions fit into the existing framework and retain the same look and feel as much as possible.

If you have questions that aren't addressed here:

  1. Search for another page that contains something similar to what you want to do and copy all the basics as much as applicable.
  2. Check the other SDL Style Guides.

  3. Post a question to Feedback and include a way to contact you.

  4. Post a question to the Mailing List

  5. Send a comment or question to <ANTI SPAM wiki AT libsdl DOT org> for clarification.

If you have suggestions for changes or additions to this document or any other portion of the wiki please don't hesitate to contact us with your thoughts. We are happy to have the participation!


Disclaimer

All content modifications are subject to review for consistency and quality. We reserve the right to remove or modify any content added to this wiki at any time. You may direct questions or concerns to <ANTI SPAM wiki AT libsdl DOT org>.

None: SGCodeExamples (last edited 2011-12-15 22:23:14 by SheenaSmith)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit