[Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

[Chris Leonard]

On Thu, Apr 11, 2013 at 10:59 AM, Chris Leonard
<cjlhomeaddress at gmail.com> wrote:
> On Thu, Apr 11, 2013 at 10:34 AM, Manuel Quiñones <manuq at laptop.org> wrote:
>> 2013/4/11 Bastien <bzg at laptop.org>:
>>> Hi Kalpa,
>>>
>>> this is a very nice and much needed project.
>>>
>>> Let's wait for Chris to chim in.  My take on this is that help files
>>> should be stored using a plain text format like MarkDown or Org-mode.
>>> It's easier to hack directly, it's easier to read diffs against such
>>> files, it's easier to feed a translator with them, and it can then be
>>> converted into Mallard (for internal browsing), or HTML (for online
>>> documentation) or... anything else.
>>>
>>> Storing directly in Mallard would be a mistake IMHO.
>


I know that Gnome projects use Mallard.  I don't really know the string
extraction workflow that results in them being posted to the Damned
Lies server.  I would guess that the gnome-18n mailing list or Shaun
McCance would be the people who would know more about that.

cjl