Skip to content

Commit

Permalink
docs: Misc
Browse files Browse the repository at this point in the history
  • Loading branch information
Hypfer committed Jan 6, 2024
1 parent 7c87bf6 commit 0367731
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 42 deletions.
75 changes: 35 additions & 40 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,27 +65,35 @@ and try to filter to avoid all this very exhausting drama.

### On (not) growing the target audience

Please please please keep those filters as-is. Please do not invite people that clearly can't pass those filters to the project.<br/>
Please do not attempt to "make things more accessible". Please do not make any video-tutorials.<br/>
It's not helping anyone.
Please keep those filters as-is. Please do not invite people that clearly can't pass those filters to the project.<br/>
Please do not attempt to "make things more accessible". Please do not make any video-tutorials.

At the end of the day, it will still be yours truly that has to deal with the support requests resulting from that.
It's not helping anyone, because at the end of the day, it will still be yours truly that has to deal with the support requests resulting from that.
Not only are my capacities limited but they also can't easily be scaled up by just throwing more resources at the problem.

I know that if you're on board the "_everyone_ MUST use this software and it MUST be _for everyone_ bandwagon",
you likely won't see what the issue with that is.<br/>
But **please**, **listen to me**. No one is winning if you facilitate a nonsense-DDoS against FOSS maintainers.
While it is true that "the community" can sometimes in some cases take over some of that load, a look at other projects
in the real world shows that this usually comes with a heavy penalty on quality and sanity.

The fact of the matter is that sustainable growth is slow, boring, iterative and usually doesn't provide any dopamine hits.

**Side-note:**<br/>
This btw is by no means FOSS-specific or even software- or IT-specific. It affects any "social" project/movement/idea.<br/>
Half-baked "I'd like to do good" **always** just backfires and **only** increases the workload on the existing volunteer structures.

Yes, short-term, there may be some benefits, sure, but that doesn't matter if long-term, volunteers quit and structures crumble,
because they were pushed into unsustainable conditions by well-meaning third-parties.
Third-parties that even feel proud having done "the right thing". Third-parties that are long gone once things start to fall
apart in consequence of their actions.
Half-baked "I'd like to do good" **always** just backfires and **only** increases the workload on the existing volunteer structures.<br/>
That is no FOSS-specific or even software- or IT-specific issue. It affects any "social" project/movement/idea.

Yes, short-term, numbers may go up and there may be some benefits, but there is no free lunch. These short-term gains
have to be paid back long-term and they have to be paid back with interest.<br/>
The problem is that often, projects then can't pay that interest and so they default.

You often have (well-meaning) third-parties that enter a project, make number go up, push the thing into long-term unsustainability
and then leave with the proud feeling of having done "the right thing", never to be seen again to be held accountable
once things start to fall apart later in direct consequence of their actions.

If you've ever seen a large corporation from the inside, this may sound familiar.

What I find fascinating about this is that the exact same thing not only keeps happening in "social" projects but also
that it is being done by people that often have strong opinions against the business world. Go figure.

It's a shame, really, but it keeps repeating itself over and over and over _everywhere_.<br/>
It needs to stop and stopping starts with a **no**.

### Being for everyone

Expand All @@ -107,9 +115,8 @@ It is however not _"for everyone"_, because _"everyone"_ is a superset of _"anyo
ideas, behaviour and whatnot.<br/>
Basically everything the individual _can_ and _does_ control.

Yes, I'm aware that controlling those things can sometimes be more challenging depending on background, but we're talking
about a cloud replacement for vacuum robots (read: luxury goods) maintained as a hobby project by some random guy on the internet and not
access to healthcare, public services, legal protection or anything vital like that provided by a nation-state or billion-dollar company.
It is true that controlling those things can sometimes be more challenging depending on background, but we're talking
about a cloud replacement for vacuum robots (read: luxury goods) maintained as a hobby project by some random guy on the internet.

Expectations need to be reasonable.

Expand All @@ -122,28 +129,16 @@ If you base the way you'd like to contribute something on that mental image, it'

### Final remarks

I know that this text will have offended quite a few people. I know they will say that this is _elitism_ or _not real open-source_
or really any other _digital blunt object used for smashing people on the head to try to force your will onto them_.

To those, I can say that this is _precisely_ why I'm not doing _open-source_ anymore. I've dropped the term and replaced
it with _opinionated_ software that just happens to be licensed under the same licenses.

_Open-source_ by the definition of that crowd is a bottomless pit that devours the souls of young, naive, motivated,
gullible and easy to exploit individuals. It burns them out to a crisp for personal and corporate profit.
It is so very unsustainable and inhumane. I'm not doing that anymore.

I'd also want to encourage other FOSS maintainers to say no. To set up boundaries and filters and stick to them.<br/>
You're already bringing a **ton** of value to other people. Don't ever forget that.
Anyone demanding even more is just being unreasonable.<br/>
It is **okay** to say no. It is **okay** to set up boundaries and not be for _everyone_.


<br/>
I do want to point out that not only do I generally enjoy the exchange with other people regarding
ideas, feedback, etc., but also that Valetudo wouldn't be where it is today without the many contributions; be it as code
or as ideas or as feedback or just as listening and being present in the community.

If you can understand what I'm saying here, feel free to stick around in the support groups :)
I think the key takeaway from this page should be that generally, contribution is welcome, but the way useful contributions
manifest for this project in this stage doesn't involve actively looking to contribute.

I for sure don't know everything and also can't do everything.<br/>
I absolutely need the input and help of other people and for that I'm glad.<br/>
Thanks for the support and for being part of the community &#9829;
There was a time in the Valetudo lifecycle where it was different. For example, the Logo came to existence because a person
was actively looking to contribute to open-source projects with no focus on Valetudo in particular. And at the time that was absolutely fantastic.
It was exactly what the project needed and looking back you can really see how "just" having a proper logo made Valetudo a lot more "real".

Without people like you, the project certainly wouldn't be where it is today!
But as said, Valetudo is now in a different situation with different wants and needs. Fear not however if you just want to
contribute to something cool and FOSS because there are a ton of cool FOSS projects out there that would love to see your contributions :)
4 changes: 2 additions & 2 deletions docs/_pages/general/supported-robots.md
Original file line number Diff line number Diff line change
Expand Up @@ -427,11 +427,11 @@ The Dreame W10 Pro is sold as:
Rooting is relatively easy. Usage of [the Dreame Breakout PCB](https://github.com/Hypfer/valetudo-dreameadapter) is highly recommended.
All warranty seals stay intact.

On my test machine, the miio cloudKey was only stored in secure storage which broke cloud communication with Valetudo.
On this robot, the miio cloudKey seems to only bbe stored in secure storage which broke cloud communication with Valetudo.
Here's a one-liner to fix that:
`mount -o remount,rw /mnt/private && printf "%s" "$(dreame_release.na -c 7 | awk -F' = ' '/MI_KEY/{print $2}')" > "/mnt/private/ULI/factory/key.txt" && mount -o remount,ro /mnt/private`

If you're rooting your W10 Pro, please let me know if you needed to run that command as well so that the docs can be updated.
If you're rooting your W10 Pro, just run that command before setting up Valetudo. A reboot might be required.

#### Details

Expand Down

0 comments on commit 0367731

Please sign in to comment.