Creator: Doc team

Audience: Course teams, Open edX community

...

Usually, after the monthly B2C Roadmap Update meeting, the product update author meets with the product advocate team to decide which features to include and emphasize. 

Around the 23 23rd of the month, the author compiles a list of possible items and e-mails the list to the Product Org <product-org@edx.org> and Product Advocates <product-advocates@edx.org> distribution lists, asking for feedback. This e-mail generally also includes any other necessary clarifying questions.

The e-mail has the following subject line.

Please respond by <time> <day>, <date>: <month> product update content

The product team has the final say on which features the product update covers. 

...

When a draft is ready, the author sends the following message to the Product Org <product-org@edx.org> and Product Advocates <product-advocates@edx.org> distribution lists.

Subject line: Please respond by <time> <day>, <date>: <month> product update

...

1. On the partner (not Open edX) portal, open the previous month's product update.
2. Between the title and the first line of text, select Clone content.
3. In the Title field, replace Clone of <former month> <year> Product Update with <current month> <year> Product Update.
4. Scroll to Domain Access Options.
5. Under Publish to, select edX Partner Portal. (Do not select Open edX Portal | Open Source MOOC Platform.)
6. Scroll to the panel at the bottom that has Revision information, URL path settings, and other tabs.
7. On the Publishing Options tab, select Draft.
8. Select Save.
9. Make a note of the URL. Otherwise, you might not be able to find the draft update again.*

      *Note: The product update URL almost always follows this pattern.

https://partners.edx.org/announcements/june-2018-product-update

The URL is the same whether the update is in draft or published form. However, if for any reason the URL does not conform to this pattern, you'll need to have the URL that you made a note of in step 9 to find your draft. You cannot search for the update on the portal until the update is published. 

Transferring the Text to the Portal

...

1. On the Partner Portal, go to the URL for the product update that you've been working on, and then select Clone content.
2. In the Title field, replace Clone of <month> <year> Product Update with <month> <year> Open edX Product Update (note the "Open edX" in the title).
3. Scroll to Domain Access Options.
4. Under Publish to, select Open edX Portal | Open Source MOOC Platform.
5. Scroll to the panel at the bottom that has Revision information, URL path settings, and other tabs.
6. On the Publishing Options tab, select Draft.
7. Select Save.
8. Make a note of the URL. The URL at this stage conforms to the following pattern.
   https://partners.edx.org/announcements/june-2018-open-edx-product-update (note that it is on the partner portal, but has "open-edx" in the URL)
   
9. Go to the two URLs that you noted to open the drafts of both updates, and then select Edit. For example, for June 2018, you would go to both the following URLs.
   https://partners.edx.org/announcements/june-2018-product-update
   https://partners.edx.org/announcements/june-2018-open-edx-product-update
   
10. In the update for the partner portal (which does not have "Open edX" in the title or URL), delete all Open edX-only information.
    1. If any, ensure that you delete the (Partner only) placeholder text in h3 headings.
    2. If any, ensure that you delete the (Open edX only) placeholder text in h3 headings.
11. In the update for the partner portal, select all applicable options in the Audience and edX Product Area lists, and then select Save.
12. Repeat steps 10 and 11 for the Open edX product update.

Publishing the Product Updates

1. Open the drafts of both updates. 
2. Select Edit.
3. Scroll to the panel at the bottom that has Revision information, URL path settings, and other tabs.
4. On the Publishing options tab, clear the Draft option, and then select the following options.
   • Published
   • Promoted to front page
   • Send subscriptions notifications
5. (optional) To change the author or date of the announcement (for example, if you create a draft on the portal on April 28 but you want the publish date to be May 1), select the Author Information tab in the panel at the bottom of the page, and then make any changes you want.
6. Select Save.
7. View the product updates to make sure they appear as you want.
   Note When you select Save to publish the Open edX product update, the OE update becomes available on the Open edX portal. The URL that you used to edit the draft, which is a partners.edx.org URL, no longer works. To view the Open edX product update, go to open.edx.org, select Announcements, and look for the update that you just published.

Notifying Ed Services

After you publish both versions of the product update, send the following e-mail to Ed Services, changing the month and year as necessary.

To: Partner Management <partner-management@edx.org>,
ES Project Coordinators <es-service-coordinators@edx.org>

Subject: The April 2018 product update is live

Body:

Hi PMs and PCs,

...