Is the community wiki actually used?
Started by welo ·
specifically https://reticulum.miraheze.org/wiki/Welcome
I'm asking as might want to write up some information about how to develop stuff for reticulum, there's not much general documentation for reticulum specially if you aren't using python (and you always make it easier for the guy after you if you can) and I'm wondering if it's official/if anyone actually uses it
for example, it took me about 25 minutes to figure out that all fields passed as environment variables for dynamic pages are passed with the prefix field_ and that's just not stated anywhere? (at least not stated inside the nomadnet guide which is what I was using) So if I can't get those 25 minutes of my life back I at least wanna help the next 100 people after me. And if there was just one general wiki for everything reticulum development or otherwise, it would be nice for on-boarding and getting people up to speed as quickly as possible
It's not official, it's made by/for the community. And it's only as good as people make it, so you're more than welcome to add to it. The content is pretty basic so far, mainly referring to the manual for more details. That is the official source of truth anyway.
Your particular issue is very particular though, particular to NomadNet even. It's the kind of issue where you have to spend some time and effort reading the code to figure it out. Or, if you're lazy, ask DeepWiki to do it for you (and hope that it gets it right).
I don't know who uses the community wiki, but it is being used… some:
https://reticulum.miraheze.org/wiki/Special:Analytics?period=31
the string "_field" is in the nomadnet source code (https://github.com/markqvist/NomadNet/blob/master/nomadnet/ line 173) Node.py so I can't be totally imaging it, but I cannot really figure out the why (there's no a single comment in this entire file); maybe something to do with using rust, hard to tell. But this is the kind of stuff I'd like to write about, Reticulum I believe is a really fucking cool concept with decent execution, but, documentation and explanation on this kinda stuff; could use some work.
As for the wiki; yea I'll go contribute new stuff, you learn by teaching anyways. I'd like it to be mildly official thing but that's a big ask when there's nothing there yet, I'll see what can be done about that. I'll at least make a page on the fundamentals for making a dynamic nomadnet page, but that'll have to be after I'm doing with nomadnet currently.
Remember that almost all of this was designed, written, tested and maintained by one strange dude living in a campervan on a donation income of around 400 bucks a month, while working on it as if it was two full-time jobs.
While I'd honestly say that the 200+ page manual covers Reticulum itself pretty decently, there is a limit to how many keystrokes one man can carry out in a year. Some code reading, discovery, experimentation and self-learning will be required.
That said, if you can alleviate the information gaps, others will probably be very thankful.
Mark wrote:
Remember that almost all of this was designed, written, tested and maintained by one strange dude living in a campervan on a donation income of around 400 bucks a month, while working on it as if it was two full-time jobs.
While I'd honestly say that the 200+ page manual covers Reticulum itself pretty decently, there is a limit to how many keystrokes one man can carry out in a year. Some code reading, discovery, experimentation and self-learning will be required.
That said, if you can alleviate the information gaps, others will probably be very thankful.
With that in mind,
I'd welcome creating a new community wiki, with an interchangeable mod system as well as a peer review system in mind.
I don't think the design principle of this wiki make it possible for it to adapt and live long and I don't see any way to contact the owner.
RE: forum suggestion
Suggesting to link the wiki on this page
falafool wrote:
Mark wrote:
> Remember that almost all of this was designed, written, tested and maintained by one strange dude living in a campervan on a donation income of around 400 bucks a month, while working on it as if it was two full-time jobs.
>
> While I'd honestly say that the 200+ page manual covers Reticulum itself pretty decently, there is a limit to how many keystrokes one man can carry out in a year. Some code reading, discovery, experimentation and self-learning will be required.
>
> That said, if you can alleviate the information gaps, others will probably be very thankful.With that in mind,
I'd welcome creating a new community wiki, with an interchangeable mod system as well as a peer review system in mind.I don't think the design principle of this wiki make it possible for it to adapt and live long and I don't see any way to contact the owner.
RE: forum suggestion
Suggesting to link the wiki on this page
It's under the Commons Attribution-ShareAlike Licence, we can fork it if this actually becomes a problem. Joakim owns the place I believe and they are actually really active, there's been a good 150 edits from them in the last 2 days so and have communicated with me on my talk page there from some edits I've done so I have no issue with the wiki right now. A better system might be appropriate later on if things get bigger but right now having one dude who owns the wiki is perfectly fine as long as they are active.
I don't think the design principle of this wiki make it possible for it to adapt and live long and I don't see any way to contact the owner.
What do you mean by design principle? It's a standard MediaWiki instance that anyone can edit and add to. If you have ideas for how things could be done better, you're more than welcome to join in and work on improving the wiki! It is a community wiki after all.
If it looks like a one man operation, it's because I'm the one who spent hours adding content to get the wiki up and running. That doesn't mean that it's my wiki or that I decide everything. I'd be more than happy to step back and have others do all the hard work :)
I'd welcome creating a new community wiki, with an interchangeable mod system as well as a peer review system in mind.
MediaWiki doesn't have a peer review feature, but edits can be patrolled by admins for quality control and pages can be protected. I'm the only admin so far, and I do patrol all edits, but I'd be happy to have others join me! For the record, I consider myself more of a janitor. I'd welcome more janitors and "peer reviewers", as long as they have proven themselves worthy of the trust.
Me being the only admin isn't really a problem. Because it's a community wiki, it's possible for others in the community to adopt the wiki should I suddenly disappear. I don't own the wiki as such, the community does.
I've added some contact info to my user page now, linked to from the the about page. Sorry, I should've done that from the start.
I hope that clears things up :)
joakim wrote:
> I don't think the design principle of this wiki make it possible for it to adapt and live long and I don't see any way to contact the owner.
What do you mean by design principle? It's a standard MediaWiki instance that anyone can edit and add to. If you have ideas for how things could be done better, you're more than welcome to join in and work on improving the wiki! It is a community wiki after all.
If it looks like a one man operation, that's because I'm the one who has spent hours adding content to get the wiki up and running. That doesn't mean that it's my wiki or that I decide everything. But somebody had to do it, so I did. I'd be more than happy to step back and have others do all the hard work :)
> I'd welcome creating a new community wiki, with an interchangeable mod system as well as a peer review system in mind.
MediaWiki doesn't have a peer review feature, but edits can be patrolled by admins for quality control and pages can be protected. I'm the only admin so far, and I do patrol all edits, but I'd be happy to have others join me! For the record, I consider myself more of a janitor. I'd welcome more janitors and "peer reviewers", as long as they have proven themselves worthy of the trust.
Me being the only admin isn't really a problem. Because it's a community wiki, it's possible for others in the community to adopt the wiki should I suddenly disappear. I don't own the wiki as such, the community does.
I've added some contact info to my user page now, linked to from the the about page. Sorry, I should've done that from the start.
I hope that clears things up :)
Hey! Love your work. Just wanted to share my worries. None of which seem to have any base of reason anyways. (Design principle of the wiki seems really robust/community based)
Didn't want to take up your time much, but appreciate it. It's cool that you added some more info.