Creating articles
Share your knowledge and make our client-facing documentation better by adding your content through a user-friendly and intuitive Drupal editor.
Go to Pega Community.
In the header of the page, click
.On the Content page, click the Add content button.
On the New Content page, click the Article link.
On the Create Article page, in the Title field, describe the article subject in a maximum of 40-60 characters, including spaces:
- For tasks, start with a gerund (-ing), for example Adding a case.
- For concepts and references, make the title a noun or noun phrase, for example Situational Layer Cake architecture.
Use sentence case. Avoid starting the title with About, Intro to, Overview of, or How to.In the Body text editor field, add your content:
Add an introduction with an explanation on the business value and on why the article is important to the user, in 1-2 sentences (approximately 50 words).
This text appears in Community search results.- Optional:
To provide additional context and background information for a task, add an additional paragraph below the short description.
- Optional:
To include a short, one-sentence description of what tasks users must complete before they perform this task, add the Before you begin section, and provide links to relevant Community articles or other content if applicable.
Add the Procedure section with an ordered list of actions that users complete as part of this task, starting each step with an imperative verb.
- Optional:
To include a short one-sentence description of an optimal result, an unexpected result, or an important outcome of the task, add the Results section, and then describe the outcome of the task.
This section is especially helpful in complex tasks. - Optional:
To provide an example of the task or concept that includes a specific scenario, add the Example section, and then describe a use case with sample values.
- Optional:
To include a short, one-sentence description of what tasks users must complete after they perform this task, add the What to do next section, and provide links to relevant Community articles or other content if applicable.
- Optional:
To add links to other published Community articles or content, in the Related content section, click the Add related content button, start typing the title of an article, and then select the article.
In the Taxonomy section, categorize the article:
In the Product Version Range category, select the start and end of the version range to which the article applies.
In the Platform Capability category, select the product capability name to which the article belongs.
In the Article Type field, specify the content type.
Use the following values:- For tasks, enter Procedure.
- For concepts, enter Overview.
- For references, enter Reference.
When you finish editing your article, at the bottom of the page, click the Save button.
- Claiming user stories
Start working on your content by identifying a subject area in which you want to share your expertise.
- Sending content for peer review
When you finish your article, share your work with the Tech Doc capability owner so that they can review your content.
Previous topic Claiming user stories Next topic Sending content for peer review