incubator-callback-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Filip Maj <>
Subject Re: [ATTENTION MENTORS] Need help re: headers in docs
Date Thu, 26 Apr 2012 18:18:46 GMT
Thanks for the reply Jukka.

Sucks that a majority of our documentation markdown files will be > 50%
license :(

On 4/26/12 9:17 AM, "Jukka Zitting" <> wrote:

>On Wed, Apr 25, 2012 at 11:15 PM, Filip Maj <> wrote:
>> Can any mentor please take a quick peek at the issue?
>Sorry for the delay. See my comment on the issue.
>> Also, a point that Mike brought up, is that we don't want comments in
>> markdown (defeats the purpose of using markdown for clean, simple
>> documentation), so if possible, would like to stick to having the
>> in just the scripts files that generate the docs, or the final generated
>> documentation HTML.
>Since those files are something that someone may well want to copy,
>use and modify separately, they should come with a source headers.
>Using the <!-- comment --> format should hide the headers from the
>user-visible HTML docs, but still keeps them visible to anyone
>modifying the files.
>Jukka Zitting

View raw message