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" <[email protected]> wrote: >Hi, > >On Wed, Apr 25, 2012 at 11:15 PM, Filip Maj <[email protected]> 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 >>the >> markdown (defeats the purpose of using markdown for clean, simple >> documentation), so if possible, would like to stick to having the >>headers >> 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. > >BR, > >Jukka Zitting
