View source | Discuss this page | Page history | Printable version   

Contributor's Guide/ModulePromotion

IMPORTANT: This article is under construction


Openbravo Module's Promotion Guidelines

This article is intended to provide some best practice ideas to promote your Openbravo Modules. First thing to take into account is that new modules must be promoted no matter whether they are "commercial" or "open source " modules. Every single module needs promotion.
The key thing here is for you/your team to decide what best promotion actions are depending on the module but for sure most recommendations listed below should be taken into account.
Once you have a clear understanding about the promotion actions you believe it makes sense to take, just make them happen.

Here are some recommendations:


Remember that a good documentation is the mean to a successful module. The wiki of the project in the Openbravo Forge is an excellent tool to make this manual available for everyone.

Functional and Technical Specifications as well as User Documentatio Guide are a must. Every single module needs that we create the corresponding documentation.

Module Definition

Before publishing the module, make sure you provide a useful help and description of your module, as this is the first information the users will get about your module. It is also very important to add an URL to the module, so that the users can navigate to the documentation.

As a summary make sure you provide useful module information listed below while creating your module in OB application path: "Application Dictionary - Module - Module" as well as while creating the corresponding project in the Forge/Wiki:

  1. Module name:
  2. Module description:
  3. Module language:
  4. Module url
  5. Module help
  6. Module author
  7. Module license
  8. Module update Information

For more detailed information about things to do before publishing your module in production central repository please follow this [[ | checklist]].

Release Notes & Roadmap

Should be available especially for huge developments like SPLP which consist of several deliverables, as this is not a must for modules but Packs.

It is recommended to follow standard Release Notes Template with reasonable changes for a particular project.


Openbravo Forge provides a tool to publish news related to the projects. Post a new whenever something comes up: at project creation to welcome users, when the module is published, whenever a new versions is released, etc.

Writing an e-mail to.... you could even get a "news" published in Openbravo ERP project itself.

This is also a must and it is an easy thing to do while creating the project, when the module is published, whenever a new version is released..etc..Keep users up to date on your modules or packs.

Communication to Partners

For important (especially commercial) modules communication to partners through Marcom should be organized.


Blog about the new feature. Write an article where the new capabilities are explained both from a functional and a technical perspective. Here are several examples ([1], [2] and [3]) of module promotion blogs.

Have a look at Blogging guidelines and recommendations at Openbravo following this link.

Mailing List

This is also a must and an easy thing to do.

Please feel free to e-mail people to let them know a new module/pack has been released, it's content and a brief description of the feature/s implemented and a link to the project in the Forge. We could use this one to let "Consulting" & "Support" as well as rest of "Engineering" team know what we do.

Additionally, an e-mail could be sent to openbravo-development mailing list providing a summary of the feature the module implements and a link to the project in the forge and the article in the blog.


And last but not least in case a module/pack is important enough, a webinar could be prepared by you/your team as this is a time demanding promotion action but really useful as promotion tool.

Webinar webpage

Please find below a link to the last webinar Localization Team has arranged and presented.



The optimum time to potentially maximize the number of attendees from America, Europe and Afrika is scheduling the webinar at 18:00CEST/CEST. This means, however, that it will be late for Asia and Oceania. Depending on the interest the webinar might rise it could be worthwhile to repeat it so that both sides can assist in comfortable schedules.

Public announcement - 2 weeks in advance

Reminder - the same day in the morning

Activities after the presentation

Preparing the demo

Material needed

This is the material recommended to deliver the webinar

Organization of the presentation

The presentation of the webinar is divided in three sections plus a questions & answers (Q&A) section. The sections and the time spent on each one can vary depending on the presentation delivered. The titles of the sections and the proposed duration for each section are:

Tips preparing the webinar

After 3-4 rehearsals the presentation will be very good and ready for delivery, you received a lot of feedback from the colleagues that attended the rehearsals and also you will feel more confortable the day of the presentation.

Using Adobe Connect

Adobe connect is a plugin for web browsers that allows to deliver presentations (image and voice) to an audience. Ismael is the administrator of Adobe connect you have to ask to generate an Adobe Connect Session link. You must have this link before publishing the main announcement message.

This are the suggested check list to follow to deliver the webinar.

Here are some tips when using Adobe Connect

Retrieved from ""

This page has been accessed 5,352 times. This page was last modified on 20 October 2010, at 08:04. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.