i think we can either to send a mail to http://apache.org/dev/infra-mail.html , or to ping on #asfinfra.
another way could be to open a jira on infra project but i think we should talk with them before. - Romain 2012/7/27 Pete Muir <[email protected]> > Romain, what is the best way to take this forward? > > I can write up a summary if that helps? > > On 25 Jul 2012, at 17:05, Romain Manni-Bucau wrote: > > > Hmm, these feedbacks are really relevant and should be pushed to infra i > > think, no? > > > > it is simply a matter of adding some hooks in the cms but i think it is > > better to had them in the cms instead of "by project" > > > > wdyt? > > > > - Romain > > > > > > 2012/7/25 Pete Muir <[email protected]> > > > >> > >> On 25 Jul 2012, at 16:36, Matt Benson wrote: > >> > >>> On Wed, Jul 25, 2012 at 10:22 AM, Pete Muir <[email protected]> wrote: > >>>> > >>>> On 25 Jul 2012, at 16:16, Matt Benson wrote: > >>>> > >>>>> On Wed, Jul 25, 2012 at 8:58 AM, Pete Muir <[email protected]> wrote: > >>>>>> > >>>>>> On 25 Jul 2012, at 07:17, Mark Struberg wrote: > >>>>>> > >>>>>>> David, the CMS is already set up and running (in SVN [1]). We just > >> need a bit more stylish css. > >>>>>>> > >>>>>>> And you can perfectly create pdf docs out of markdown. > >>>>>>> > >>>>>>> Of course we can also use alternative formats. But to me this is > >> like a colour preference - markdown is supported out of the box and > >> provides all needed options. > >>>>>> > >>>>>> My only concern here is that Markdown doesn't support a few useful > >> things for full on docs (vs readmes and snippets of text): > >>>>> > >>>>> FWIW, > >>>>>> > >>>>>> * admonitions > >>>>> I.e., warnings? What are you looking for here? > >>>> > >>>> Yes, admonitions is the term given (I think by docbook) to the boxouts > >> that are e.g. Warning, Info, Important. > >>>> > >>>>> > >>>>>> * callouts on code > >>>>> Again, not sure I know what you're meaning here. > >>>> > >>>> I can have a little icon (e.g. a 1), next to a line of code, then a > >> table at the bottom of the codeblock that links to that. Allows you to > >> annotate a code block with notes. > >>>> > >>>>> > >>>>>> * a standard way of indicating what the source language of a code > >> block is > >>>>> Apache CMS has this. > >>>> > >>>> Cool. How would this work if we were also producing pdfs and epubs? Is > >> this a standard extension to markdown? > >>> > >>> Yes; the code highlighting is done with > >>> http://freewisdom.org/projects/python-markdown/CodeHilite; depending > >>> on the structure of whatever mechanism would be theoretically used to > >>> produce other formats, we'd presumably just make the same extensions > >>> available. > >> > >> That works :-) > >> > >> > >
