I don't know if this will be a popular proposal, but I really believe that
setting up a self-hosted Wiki could be a very good choice. No complicate
git clone, no complaints, just read/edit what you need, and distributed
responsibilities about its design and direction.

My two cents

On Tue, Mar 1, 2022 at 8:02 PM William Liquorice <will...@howhill.com>
wrote:

> Hello,
>
> A year or two ago, I tried to wrap my head around GNUnet so that I could
> try to make parallel implementations of small bits in Rust, but found
> its documentation to be utterly impenetrable. Not even from a technical
> standpoint, the massive reference manual / "handbook" is quite
> overwhelming and more akin to the Lord of the Rings.
>
> Just now, I decided to look up the documentation for GNUnet's IPC
> functionality. This is a pretty important component of GNUnet's
> modularity. One rather important section about sending an example
> AddressLookupMessage between has the immediate subheading "FIXME: This
> is very outdated, see the tutorial for the current API!"
>
> To my annoyance, there is no link provided to this tutorial. Where is
> it? I will put the link in there myself if it exists.
>
> I am unfamiliar with how exactly documentation is put together for
> GNUnet, but just separating out the contributor's/developer's handbook
> (most of the page) would make the actual user manual significantly less
> intimidating. It doesn't need to all be on one page.
>
> I also made some SVG diagrams of specific GNUnet subsystems (the core
> transport -> CADET stack, GNS, VPN), but I don't recall ever hearing
> back from anyone about them. Are they any good?
>
> Thanks,
>         Will
>
>

Reply via email to