How do I create a selection in AWS re:Post?
Are you looking to learn how to build your applications in the cloud or solve your technical issues with one piece of content that has all the information you are looking for? If you are interested in curating content, create selections for common use cases that communities can benefit from.
Note: Only community members with Star status (5,000 or more points) can create a selection on AWS re:Post.
What is a selection in re:Post?
On AWS re:Post, a selection is a learning path or a curated set of content assets that are relevant to a use case, technology domain, industry, or specific problem area. It is a collection of knowledge assets specific to a customer's use case within AWS services and contain high-quality content from AWS sources, such as re:Post, Knowledge Center, AWS Blogs, and AWS Documentation.
How do I get started?
- Identify a targeted and specific AWS technical use case that is a common ask from your customers. Examples: How do I get started with the cloud, how do I migrate my on-prem workloads to the cloud, how do I troubleshoot common S3 errors. These use cases can be tied to any step in a customer's cloud journey, such as learn, design, build, deploy, and operate.
- Review different AWS content properties, including but not limited to AWS Documentation, AWS Blogs, AWS Prescriptive Guidance, AWS re:Post Questions, Knowledge Center, AWS training resources, and videos. Narrow down to the resources that offer high-quality information and guidance on the use case. Make sure that you pick the resources with accurate and current information. Make a list of these resources to create a content set that you will further curate.
- Group the content set into a few sections based on relevance and context. For example, if you are creating a selection on troubleshooting an error code, you can choose to divide the content set for this topic based on the root causes for this error. Categorizing assets into coherent sections improves the readability and ease of use of the selection.
- Create a selection in AWS re:Post.
How do I create and publish a selection on re:Post?
Follow these steps to publish a selection in re:Post:
- From any page in AWS re:Post, choose Post content. Then, choose Create selection. -or- From any page in re:Post, choose Create selection. Note that you see these options only if you are a Star member.
- On the Create a draft page, for Selection title, enter a title for your selection. Make sure that the title is simple, specific, and self-explanatory.
- For Selection description, enter a description for your selection. Define your description so that the selection is discoverable through search within and outside of re:Post.
- For Short description, enter a meta title for your selection. In this field, you can include a few words to briefly describe the selection to improve the visibility in search engines.
- For Tags, select up to five tags that apply to the selection. The selection, when published, will be associated with these tags.
- For Title image, upload an image that describes the selection on sight. The maximum size of the uploaded image must be 2 MiB. File types, including .jpg, .peg, and .png, are supported. This image is the cover image for your selection on the selections tab where all published selections are listed.
- On the Content section, for Title, enter a title for your first section. The purpose of creating a section is to organize the assets based on relevance. For example, if you are creating a selection on monitoring the resources for a certain AWS service, you can create individual sections on monitoring methods, statistics, monitoring benefits, and error handling based on monitoring. Make sure that the title and description for each section is specific to what you cover in the section.
- For Description, enter a description for your section.
- For each resource that you want to add to the selection, choose Add link. A resource is an AWS asset that provides information relevant to this section. For example, if your section is about using a Machine Learning solution, you might choose to add Evaluating your ML project with the MLOps checklist as a resource.
- For each link that you add, do the following:
- For Add a link, enter the link for the resource. The Title field is auto-populated.
- For Description, optionally enter a short description about the resource.
- For Add image, optionally upload an image that describes the linked resource. The maximum size of the uploaded image must be 2 MiB. File types, including .jpg, .peg, and .png, are supported. This is the cover image for the card that displays information about the resource that you're adding. If you don't add an image, the default image is populated.
- Optionally, choose Add body to include text and inline images for the section. Use this function to add some additional information or images related to the section. You can include text or image within body. Images are aligned to the center, by default. To align an image to the left, enter #left at the end of the image URL. To align an image to the right, enter #right at the end of the image URL.
- To add another section, choose Add another section. Repeat steps 7 to 11.
- After adding all sections, choose Create draft.
- To edit your selection draft before you publish, choose Edit.
- When you are done editing your selection, choose Publish.
After moderation, your selection is published under the Selections tab.
What are some of the best practices that I can follow?
- Keep your selection fresh, accurate, and current.
- Be sure to proofread and review the selection before you publish.
- Use simple and clear language.
- Use images and iconographies as needed to improve engagement.
- Make sure that all the sections in a selection flow well and come together to present your use case.
- Use the description or body in a section to include information on how the resources in that section relate to each other.
- Refrain from including identifying or confidential information in the selection.