Difference between revisions of "Contributing to the Wiki"

From PegaWiki
Jump to navigation Jump to search
m (minor section title update)
Tag: Visual edit
m (add)
Tag: Visual edit
Line 38: Line 38:
 
* Commentary or subjective opinion on products of other vendors or the vendors themselves
 
* Commentary or subjective opinion on products of other vendors or the vendors themselves
 
* Quotes containing commentary or subjective opinion on products of other vendors or the vendors themselves
 
* Quotes containing commentary or subjective opinion on products of other vendors or the vendors themselves
 +
* test
  
 
== Need support or have questions? ==
 
== Need support or have questions? ==
 
Contact the [mailto:PegaWikisupport@pega.com PegaWiki team]
 
Contact the [mailto:PegaWikisupport@pega.com PegaWiki team]

Revision as of 20:37, 16 November 2020

It's a group effort![edit]

Pega Community Wiki depends on your participation! If you have a design pattern to share, go ahead and add it! You should also expect that your colleagues might make edits or suggestions.

What's the difference between an edit and a suggestion?[edit]

Edits are made directly to a design pattern. If you have additional content that would enhance the design pattern, or notice something that should be corrected, use the Edit function. For example, a section on Making pizza at high altitudes could be added to the Making Pizza design pattern. Note: Editing is currently available to Pega employees and will be curated prior to publishing.

Suggestions provide a forum for recommendations and questions. For example, "This is helpful, but it would be great to have details on how to make pizza dough at a high altitude," or "What types of tomatoes are recommended for a great pizza sauce?"

Note: Suggestions can currently only be made by Pega employees. Moving into phase two, we will be opening up this feature for authenticated users.

It all starts with a good title[edit]

Titles give the essence of the information that a user is about to digest. Giving your article an attractive, interesting title is a key part of the writing process. The following simple guidelines can help you to create good titles:

  • Do not write "Best practices for...", as this creates problems with the Wiki engine's sorting and display of articles.
  • Capitalization: Use sentence-style capitalization (capital letter on the first word and proper names), not headline style (capital letters on every word).
  • Length: Long-winded titles look bad and risk becoming incomprehensible. Provide enough information, but don't try to summarize the entire topic in the title.
  • Action verbs: Use active voice and positive statements to give your titles impact. For example:
    • Good: Making white sauce for pizza. Bad: Best practices for white pizza sauce.
    • Good: Diagnosing your system with the Performance tool Bad: Use the Performance tool to diagnose your system
    • Good: Migrating customer data from Salesforce to Pega Sales Automation Bad: Ways to migrate customer data from Salesforce to Pega Sales Automation

How to create great content?[edit]

In your writing, there are three simple guidelines that will help you create the best possible content:

  • Be clear: Use simple sentences to communicate. Avoid uncertainty when providing instructions.
  • Be specific: Write exactly what you need to communicate. Be precise and only include the necessary details.
  • Be consistent: Your style, structure, format, and use of terms should be consistent.

Content to avoid[edit]

Review and follow these guidelines to ensure that Pega Community Wiki is a healthy, vibrant community.

Pega Community Wiki content should not include:

  • Personal content
  • Customer references
  • Customer names
  • Competitor references
  • Competitor names
  • Company confidential information
  • Commentary or subjective opinion on products of other vendors or the vendors themselves
  • Quotes containing commentary or subjective opinion on products of other vendors or the vendors themselves
  • test

Need support or have questions?[edit]

Contact the PegaWiki team