How to create your own article and contribute to the resource center
Thanks for your interest in creating developer resource content! All the information you need to create, edit and submit your content for publishing is right here.
First, some details on permissions:
We encourage you to collaborate with your fellow community members when creating new articles. For example, you can split up writing parts with a team of contributors or you can leverage existing posts from original authors from the Community Support Forums. We believe the more the community collaborates on this content, the greater value it will be for everyone. We look forward to reviewing your articles!
Here’s a step-by-step guide for creating, editing and submitting new articles for review and publishing.
Creating and Editing Developer Resource Articles
You use the Article Editor page to create and revise articles. The template you choose determines the sections and layout of the article. If you create the article based on a topic, the clipping area on the right lists all the posts in the topic. You can drag text and images from the clipping area into the article, or add your own text. When you drag content into the article, the system adds a link for the post and credits the author as a contributor.
When you create an article, you can add labels that help others locate the article and a teaser, which is required if you want to feature the article at the top of a topic page (i.e. Java Development).
When you revise an article, you can drag new content into the template from other posts and comments or edit the existing content. You can also add or remove links and contributors. Revision notes appear in the Article History page and make it easy to track changes, especially in long articles.
While you can write articles from scratch, most articles in the Resource Center will be based on content that already exists in community forums. This means you can start an article with an existing forum topic. You can look for relevant forum topics through tags or by searching keywords.
In addition to the content, Resource Center articles contain links to related posts as well as to the authors of those posts. When you drag content into an article, links to posts and topic participants are created. Both the author and the topic’s participants get credit for their contributions to the article.
Starting an article
To begin writing an article, choose a template, and click Start Article. The Resource Center provides the following article templates:
Note: The Solution section is given a background color for emphasis.
Once you have chosen your template, the New Message page is displayed, showing the subject (the same the topic you selected) and the template you chose. The posts from your topic appear in the clipping area to the right of the Editor.
Adding content to an article
The Editor contains the sections from the template you chose. The clipping area to the right contains the posts from your topic as well as tabs that let you search for keywords or find content based on your tags.
You can drag content from the clipping area or type your own. Any images, links, or formatting in the original post are preserved when you drop the content into the article template.
To add content to an article:
If the post is long, you can view the full contents by hovering the pointer over it in the clipping area.
As you drag a post, the section where the text will appear is highlighted.
When you drop the post, it becomes part of the article and can be edited. The post is added to the Related Links list for this revision of the article, and the author of the post is added as a contributor.
To edit the text, click in the text area and start typing. Click out of the text area when you are finished editing.
Note, when creating relatively long articles, you may need to click in the editor again to re-display the toolbar.
Applying finishing touches to an article
In addition to the content of an article, there is other information you can add that will make both the article and the related material easier for users to find:
To add finishing touches to an article:
Saving a draft
You can create a new article all in one session or save the current draft and pick it up again later. You have the following options when you save a draft:
Editing an article
While a community created article is still in draft state (before it is submitted to RIM for review and approval) community members can edit the article.
Once an article is published, the content is locked. While the published content will be locked authors and editors will be able to comment on these if they see an opportunity for improvement.
To edit article content:
Managing links and contributors
The system creates a list of related links and contributors when you drag content from elsewhere in the community into an article. In addition to consolidated lists for all revisions, the links and contributors from the current revision appear in their own lists.
For related links, you can add links for other content in the community or remove links that are added automatically. You might, for example, want to remove duplicate links to the same topic.
For contributors, you can also add or remove names from the list. You might, for example, add the name of a community member who has posted extensively about this topic or remove the name of a contributor whose content was edited out of the article or a user who made a minor correction.
Saving a revision
Before you save a revision, it’s important to annotate your changes. This lets other editors see your reasoning and helps RIM evaluate your revision in the approval stage and whenmaking publishing decisions. If you include a revision note, others can see it on the Article History page.
It’s a good idea to mark minor changes, such as typo corrections, so that users who subscribe to changes to the Resource Center are not inundated with notifications.
To save a revision:
Commenting on an article
You can comment on an article in the same way that you do on a blog article or an idea. Comments are your opportunity to help improve and maintain the Resource Center. Authors and editors can see your comments and may choose to incorporate them into the article. If that happens, you may even get credit as a contributor.
The comments section of each article is at the very end. To view the comments for an article, click the comments count.
To comment on an article complete the following steps:
Setting your Developer Resource Center subscription options
You can subscribe to the entire resource center or to a specific article. You might, for example, subscribe to a particular topic that you’re interested in (for example Themes & Animated Graphics). Or, you might want to keep tabs on an article you commented on or contributed to.
If you have already set your preferences to automatically subscribe you to topics you participate in, you will be notified about new comments or changes to an article. You can also refine your subscription preferences for specific types of changes to an article. You can set your subscriptions to notify you only when a new article is published, or to skip notifications for minor edits.
To set your resource center subscription options complete the following steps:
Skip notifications for changes to published or draft articles. Choose this setting if you just want to know when new articles or revisions are published (using the general Developer Resource Center subscription)
New articles only
Be notified when the first draft of a new article is saved to the resource center. Choose this setting to be advised when development starts on new articles.
Skip minor edits
Skip notifications for changes to published articles or drafts that are designated by the author or editor as minor edits. Choose this setting if you are only interested in substantive changes rather than typos or other minor changes.
All revisions/All edits
Be notified when any change is made to a published article (a revision) or to a draft (an edit). Choose this setting to be informed of all editing activities in the resource center.