Hi,

to be honest, the documentation needs an overhaul. There were some ideas to move it to sphinx and to have a more coherent structure. I've started with the conversion to restructuredText [1] some years ago but the person interested(?) in doing more work on the documentation in sphinx didn't continue the work. Maybe I have to lure Linus and Simon with some ice cream and discuss some ideas with them.

On Wednesday, 5 August 2020 15:35:44 CEST Venceslas Ngounou via B.A.T.M.A.N wrote:

• An up to date documentation on Echo Location Protocol (ELP). On open-mesh.org, the dedicated page has the mention OUTDATED.

Yes, I've added the "outdated" because this documentation describes some ideas various people had. But they were not synced when the actual protocol was implemented. Things (most likely not complete) which don't line up:

* actual packet format is completely wrong * not neighbors are announced but the "own" originator * padding is not used for broadcast ELPs * unicast ELPs are completely valid (for rate control probe packets)

Would be nice if the page could be checked and fixed by someone more familiar with ELP.

• An up to date documentation on the different packet types

What do you have in mind here? Best documentation for the actual binary format is the uapi file batadv_packet.h [2]

• Scientific papers (if any) related to the design or the modeling of the actuel version of BATMAN-adv.

Since batman-adv was never a traditional academic project, there were no papers written about it by the original authors during the development.

But there are two pages with pointers to various papers [3,4] but there weren't updated in the last 3 years. So you might find more interesting things on Google Scholar [5].

Kind regards, Sven

[1] https://git.open-mesh.org/doc.git [2] https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/incl... [3] https://www.open-mesh.org/projects/open-mesh/wiki/Experience#Papers [4] https://www.open-mesh.org/projects/open-mesh/wiki/New_papers [5] https://scholar.google.com/scholar?q=batman-adv