[dev] Missing developer documentation
Lou Berger
lberger at labn.net
Mon Dec 11 16:18:55 EST 2017
so it seems there was some discussion on this in August where the
agreement among those who participated in that weekly call was to move
to reStructuredText (reST) .
Does anyone care to comment on this? , i.e. are you (not) okay with
replacing the current md and texi formats with reST?
There is a PR starting this change...
Thanks,
Lou
PS I have no memory of the discussion (and may even have been there
with glazed over eyes) so was surprised by the PR
On 7/25/2017 9:35 AM, Olivier Dugeon wrote:
>
> Hiall,
>
> There is missing developer documentation in FRR. In PR #805 I try to
> update an old Zebra hacking document, but that seems too old to be
> publish, so I prefer to remove it as suggested during the PR review.
>
> For me, the main problem is how to start writing a such documentation ?
>
> First, it is too huge and to complicated to be written by only one person.
>
> Second, we need a dedicated space (e.g. a new doc project inside
> FRRouting) to collectively write such documentation and then push into
> frr master documents when they are ready.
>
> Finally, we need to organize themselves in order to collectively
> decided how to write them, to formalize the document through a common
> template, to harmonize the documentation...
>
> I would start by proposing:
> * start discussion about this new topic (create a new issue in
> github) during regular meeting
> * decide the document format (Markdown, in line github Wiki, LaTeX,
> TeXi ...)
> * create a new doc project within FRRouting
> * propose template
> * propose Table of Content for each document (perhaps partially common)
> * open contribution to the different documents
>
> Comments are welcome.
>
>
> Regards
>
> Olivier
>
>
>
>
> _______________________________________________
> dev mailing list
> dev at lists.frrouting.org
> https://lists.frrouting.org/listinfo/dev
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.frrouting.org/pipermail/dev/attachments/20171211/4396b1e4/attachment.html>
More information about the dev
mailing list