(release notes generator) How to convert python dictionary to release notes using sphinx?

Joel Sherrill joel at rtems.org
Thu Jun 7 19:21:30 UTC 2018


On Thu, Jun 7, 2018 at 1:45 PM, Gedare Bloom <gedare at rtems.org> wrote:

> Hello Chris, Dannie,
>
> I am leaning toward a lighter method such as markdown for the release
> notes. They are not necessary to be a beautifully formatted document.
> Some basic document sectioning, lists, and url support seems
> sufficient to me. This would also be easily parseable by other tools
> in case someone wants to write some further scripts to process the
> release notes, for example, to generate traceability documentation.
>


I am OK with using something simple like markdown. The output needs
to be "acceptable", not "beautiful". Plus I expect that there will be things
in some tickets which are nearly impossible to pass through any processing
and formatter without getting mangled. Might as well keep it simple.

Is there documentation on the markdown format supported by the RSB?

I assume it can be used to produce PDF and HTML.

--joel


>
> On Wed, Jun 6, 2018 at 11:55 PM, Dannie Huang <danxue.huang at gmail.com>
> wrote:
> > Hi Chris,
> >
> > Code is pushed on my github (link is attached below), it would be great
> if
> > you can review it for me!
> >
> > https://github.com/dh0072/ReleaseNotesGenerator
> >
> > I would go to check how Markdown works, thank you!
> >
> > -Dannie
> >
> > On Wed, Jun 6, 2018 at 10:46 PM, Chris Johns <chrisj at rtems.org> wrote:
> >>
> >> On 07/06/2018 13:40, Dannie Huang wrote:
> >> >
> >> > Currently data from milestone page and ticket page is stored in python
> >> > dictionary,
> >>
> >> This is great. Where is the code so it can be reviewed?
> >>
> >> > how can I convert python dictionary to release notes using sphinx? I
> >> > have checked sphinx documentation but not exactly sure how to do it.
> >>
> >> I am not yet sure ReST and Sphinx is the best solution. We need to
> decide.
> >>
> >> We could use Markdown and get a similar result. The RSB has a Markdown
> >> implementation ...
> >>
> >> https://git.rtems.org/rtems-source-builder/tree/source-
> builder/sb/markdown
> >>
> >> Chris
> >
> >
> >
> > _______________________________________________
> > devel mailing list
> > devel at rtems.org
> > http://lists.rtems.org/mailman/listinfo/devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20180607/7c7c2c6d/attachment-0002.html>


More information about the devel mailing list