Iām guessing this string can be whatever you want it to be.
But yeah, I agree in general, some of the docs can be pretty opaque. For example, I wanted to configure NextCloud w/ Collabora in Docker, and I kept getting errors when trying to do what a few sites recommended. I ended up figuring it out, but only through trial and error. Iām going to go through the same pain this weekend when I try out ownCloud Infinite Scale up and running to compare.
I had very similar experiences with OCIS. Got it all set up following the quick start guide, found extremely odd and unacceptable behaviour with storage space ballooning, start troubleshooting and find āoh you had to do this, this and this manually, itās in the docsā It is in the docs, but never referenced by any other part of the docs. Because why would you mention the thing that the admin must manually set up in 100% of installs in your setup guide?
Anyway Iāve become that guy ranting on the internet that I donāt want to be. So just so you donāt suffer as much as I did; you have to create scheduled tasks via cron or your preference of scheduler to clean your uploads folder and data blobs. This also did not fix my specific issue and I ended up giving up on OCIS and sticking to Nextcloud.
Iām going to run both in parallel for a month or so before trying to get my SO to use it so I can better estimate the WAF. So far, NextCloud is good enough, but itās kinda slow (and I have Redis configured) despite being on pretty beefy hardware (Ryzen 1700 w/ 16GB RAM). I really hate PHP, so Iād prefer a project I can contribute to if needed. I worked w/ Go for almost 10 years, so OCIS would be a natural fit, but Iād still contribute patches for PHP if that really was the best tool for the job. But Iām not going to get involved unless the project already does what I need (my contributions would be for smaller bug fixes).
But yeah, the OCIS docs look kinda mediocre from the little Iāve read of them. But at least I donāt need to mess w/ PHP config most likely and can hopefully just forward HTTP requests to it.
The move from php to go and the slowness of NC is what attracted me to the project. But Iām going to wait a bit longer until weāre flush with 3rd party setup guides cause I simply do not have the time to wade through their docs.
Yup, thatās why I started w/ NextCloud. It was painful enough getting Collabora working with NC, so hopefully OCIS is easier now that I know my Collabora setup at least works.
About 15 years ago I went on a trip from San Diego to NY. We were staying in a shitty Days Inn in some some town. We left our luggage in the rooms, and went out for the day, and I had left my iPod nano in there. When we came back that evening, my iPod was gone and my package of brand new boxers was missing a pair also. I assumed they hid the iPod in the rolled up boxers. We went down to complain to the front desk but they didnāt give a shit. Lessons were learned that day. I was so excited to listen to Biggie āGoing Back to Caliā on my way back to Cali and thatās what was REALLY stolen from me :(
Maybe someone saw you listening to it on the way in and they don't get paid enough to care and grabbed something for their kid =_o! Sorry either way, that sucks. I bet you hated the rest of the trip too.
Yeah the documentation (if it even exists) of most projects is usually clearly written by people intimately familiar with the project and then never reviewed to make sure it makes sense for people unfamiliar with it. But writing good detailed documentation is also really hard, especially for a specialist because many nontrivial things are trivial to them and they believe what theyāre writing is thorough and well explained even though it actually isnāt.
You have to assume some level of end user knowledge, otherwise every piece of documentation would start with āWhat a computer doesā and āHow to turn your computer on.ā
Iāve found the best practice is to list your assumptions at the top of the article with links to more detailed instructions.
Another case is listing a huge number of steps to do some task, without acting describing what the end goal for each set of instructions is (common in āhow toā guides, and especially ones that involve a GUI).
This means that less technical users donāt really understand what is going on and are just following steps in a rote way, and it wastes the time of technical users since they probably know how to achieve each goal already.
I agree with this. When I publish my code, it is documented for someone in my field with around my level of knowledge. I assume you know DNS, I assume you know what a vector is, I assume you know what a dht is, I assume you know what O(log n) is.
Iām not writing a CS50 course, Iām helping you use the code I wrote.
Might be different for software like libre office which is supposed to be used by anyone, but most software on earth is built with other developers in mind.
Thatās why blog posts rock. Most popular projects will have a dozen blog posts for different configurations. For example, when looking to set up NextCloud, I found docs for almost all combinations of the following:
Apache and Nginx configuration
running through Docker or directly on the host
MariaDB and Postgres configs (and SQLite, with proper disclaimers)
Collabora and OnlyOffice config
It does take some knowledge of each of the above if you need one of the few configs thatās not available on a blog post, and some of the posts are outdated, but with a bit of searching almost everything is documented by someone on the internet.
This shouldnāt be necessary (official docs should be more comprehensive), but at least itās available.
Okay, please point me to the blog posts that helped you with collabora/onlyoffice. Thanks have NEVER been able to get that to work with my nextcloud (currently using the Docker AIO).
Iām not at the same computer I used to look it up, so I donāt have my search history, but I think this one was pretty decent. I donāt use Traefik, but the rest describes the important bits w/ docker compose. I donāt know much about the AIO image though (I used separate images).
Same with me. I played around with the setup a few times on my local machines. It took quite a bit to get it set up, then I saw an error after a couple of days and gave up. Its easier to just pull down the file and run it locally than use collabora.
Iād rather have a great documentation than five different blog posts, where some of them might be outdated, wrong or insecure (and you only find out later).
But yes, they are helpful and easily available for popular software.
My CS major required me to take two upper division English classes and I think they helped me more in my career than my upper division CS classes. People forget that documentation is for ourselves too
Iām really thankful that I had a great English teacher in high school, and that my degree required a technical writing class. Being able to write a coherent email got me further in my career than the technical stuff I learned in college.
There is a case to be made that people should be a bit more well rounded in general, and not just find a specific niche.
So non-technical people should still have a decent familiarity with computers and maybe be able to do some very basic coding. And technical people should spend some time working on their written and verbal communication.
Because in both cases, it makes people more effective in their roles.
Totally agree. And Iād argue that we donāt even need technical writers. Even if all people do is correct grammar and spelling mistakes it would be helpful, let alone actually writing docs. Itās one of the easiest ways non-technical folks can get involved with open source projects.
I think this is why the āmy code documents itselfā attitude appeals, even though itās almost never enough. Most developers just canāt write, nor do they want to.
The problem with āItās self-documentingā is that there are inevitably questions about what it says, and thereās no additional resources to pull from.
The information that familiarity gives you is āWTF does this field meansā, and itās the only thing thatās actually there. How you get a value and how a value is formatted are things no amount of expertise will save you from having to tell the computer, and thus you canāt just forget about.
(And let me guess, the software recommended install is a docker image?)
I donāt think itās (just) that. Itās also a different skill set to write documentation than code, and generally in these kind of open source projects, the people who write the code end up writing the documentation. Even in some commercial projects, the engineers end up writing the docs, because the higher ups donāt see that theyāre different skill sets.
This is why I did a āwalkthrough testā when I had to write documentation on this sort of thing. Iām a terrible technical writer, so this shit is necessary for me.
I grabbed my friend who knows enough about computers to attempt this, but not enough about infrastructure to automatically know what I meant when I was too vague.
Took two revisions, but the final document was way easier to follow at the end
Reminds me of the time I asked a question about a Magic: The Gathering card tomy local game storeās Facebook page. The card was Sublime Archangel. I asked what happened if it gave a creature Exalted that already had one. Someone sarcastically replied that it already says it on the card. I was a new player, how was I supposed to parse the phrase āIf a creature has multiple instances of exalted, each triggers separatelyā? For all I knew that could mean that they didnāt stack because they would need to trigger together. I didnāt have the vocabulary to understand those things.
I try to remember this when explaining what I might believe are simple concepts to people because that person really upset me.
100% Agree, it feels like most documentation is written in a way that expects you to already know what itās talking aboutā¦ When itās the documentationās job to teach me about it.
We were on holiday at a camp ground when I was child. I had my Nintendo DS with me and I think during this vacation I even bought a carrying case and some games for it with my own money. During the day we would ride bycicles to other places so I left it in the tent buried under some stuff. One day when we came back i could not find it. At first I thought it could be stolen or my dad tried to hide it from me, because I played with it quite a lot which he wasnāta fan of. So I tried to look through his stuff without him noticing to find it. But i didnāt find it and since i am quite reserved i didnt want to bring it up that it was missing.
In the end I think someone at that camp ground must have seen me use it and then waited for us to leave to steal it, since nothing else was stolen.
After that every time someone asked me why I wasnāt playing as much as before I told them that I didnāt feel like it. And Iām not sure whether they figured it out to this day.
Yeah, I said something like that a second ago to the person who had their iPod stolen. Probably someone saw someone using it and ganked it. A couple of years ago my gal's hair dresser went on a hike with her boyrfriend and he brought his switch and left it in the car (idk if it was seen or not). But they broke the windows and stole it. And I later heard trail heads are easy targets for scummy people.
I don't like people floating weed as this innocuous thing. I've met some really shitty potheads. But I also know that I've more than likely met a bunch of grounded regular smokers too. I don't think people should go to jail for it, but I def think it brings out some really awful characteristics in some folks. But that's just me. I mean when it's legal (cause it most def will be her cross-country at some point) I think people will start talking about it the same way they talk about alcohol. Because some folks will drown themselves in it. But also hopefully at that time, we might also start addressing our horrendous food situation too. Shrugs.
I've got nothing against weed. Like I have indulged recreationally myself a time or two, and honestly other than the occasional giggles I don't really see the appeal.
I think it affects everybody differently, for me it's just usually too heavy and too strong to indulge in other than every once in awhile.
Oh for sure it affects everyone differently. And I know different strains for different things. I sort of forgot, but I tried a slew again like five years into my pain period. Just to try to figure out if I could fix stuff with it. Hilariously it always seemed to make my pain worse, so it's probably outright just not for me. Shrooms? My jam. Weed. Eh.
I have just seen people basically neglect themselves, let alone others who depend on them - all in the name of weed. So ultimately I don't care too much for it as a whole.
Ah, I totally didn't get this first go round because my brains were trying to put together how a->b. But I get it now, and it also kinda reminds me of this goofabout.
But think about the speed youād get on the way home!
Also I grew up on a bluff, I had to go down a big hill and back up twice every day. After a summer of going it I was powering straight up a monster hill every day. Itās daunting for a few weeks though.
Yeah, itās like when Iām by myself out in the wild away from people, houses, or roads. I suddenly realise how constant noise is everywhere else in my life; especially because my house is right next to a highway which has cars and trucks passing constantly, and a train track right next to it too. And because I live in a country area of Australia, the night-time traffic suddenly becomes so small, that the difference in noise between day time and night time noise is massive. Even so, thereās always noise coming from somewhere: right now itās from my keyboard and my computer fan, and itās night, so I canāt hear any vehicles passing.
My Indian friends tell me that Indian people are the most racist people in the world, to other Indians. Thatās the biggest problem and why they left. Youāre clearly a part of that. A traditional caste system and the usual socioeconomical issues of a large population obviously wonāt help. These seem to be the cores of your issues. Itās not your fault, but you shouldnāt participate in that bullshit by saying such things and having such a defeated mindset.
You need to travel. You need to leave.
After you travel, you can self-assess under a more experienced and open perspective. You will likely not want to return, but you will not be hitting the world so jaded and focused on competitive success within society. You will relax, you will get options, you will settle into a comfortable life and in a few years you will complain about the mediocrity of being middle-class instead.
āBut I canāt travel.ā
Yes you can. You have plenty of skillsets that will earn you more money per hour elsewhere. All the while building up friendships, networks, and experiences. Your only issue is visas which you co-ordinate as you go. For now, much of the western world is very open to Asian immigrants and youād be foolish to not jump on it while itās still an option. Target the richer nations with low unemployment rates and youāll find secure work.
Your main issue will be later when domestic family want part of what youāve gained. Thatās up to you. I have a friend that I found out was giving more than half his income back home because $60K AUD seems huge to people not paying $550 a week in rent. And Iāve also got a friend that, after her father died, threw her middle fingers to family and India vowing to never return.
Your situation is harder to endure than just leaving. But the amount of blame and hate you put on your circumstances makes me wonder if you can even realise that.
But as a white guy with 13 friends from Nepal, India, and Bangladesh, Iād like to think my advice isnāt entirely disregardable, as itās indirectly from them.
Edit: Ah shit, I forgot that apart from visas your only other issue will be racism. It really depends on the industry and nation, but obviously there will be those anti-immigration even though they donāt realise immigration Is saving their fucking livelihood. Plus, if you talk about India and Indians the way you did In your post, youāll fit right in with them lolāthats not a good thing long-term, but I guess an odd uptick (???)
Point is, whoever you are, you were born and will die. Go find a place in the world that youāre not miserable in. Thatās your current meaning in life.
Thatās the biggest problem and why they left. Youāre clearly a part of that.
Sorry, I am not racist. I know all this way too well. i.e., The corrupt bureaucrat and the politician who created this system knew all too well what he was doing and he had good personal motivations for it. I myself have put myself in their shoes and their world, and have tried to see whatās working in their mind. I wonāt say I am racist, if I am racist I am towards the culture which created this shitshow. But you have good reasons to think that given my post. I am not blaming any ethnically or linguistically different group for where we are, I am blaming the culture. Babies are not born creepy, the culture makes them what they become. The creepy guys I talk about, I am pretty sure they wonāt have been creepy in a better culture.
not your fault, but you shouldnāt participate in that bullshit by saying such things and having such a defeated mindset.
Trust me, I once had hope, but this system beats it out of you! This system has failed me multiple times in dire ways. That being said, you are 100% correct, defeatism and resentment, nothing good comes out of them. I am no longer resentful as much as I used to be, I will try to keep that defeatism at bay!
But as a white guy with 13 friends from Nepal, India, and Bangladesh, Iād like to think my advice isnāt entirely disregardable, as itās indirectly from them.
Trust me, I read it very intently. I will try to follow what you have suggested, I have a few friends abroad (White Native borns), they know and understand me, they will help me get out! :)
, if you talk about India and Indians the way you did In your post, youāll fit right in with them lol
I donāt blame them tbch, but yeah, I plan on mixing with the non-racist bunch and spending my spare hours in the library if I ever get there! Kudos!
I appreciate the effort and the intention behind your reply, thank you very much for trying to help me!
Sorry. Itās easy for me to say, āBe more positive!ā when my feet have never been in your shoes. Sorry if it seemed patronising in any wayāits good advice, Iām just bad with choice of words a lot of the time. You seemed to understand my point, though. Perhaps a good (paraphrased) analogy is one I learned in Uganda; donāt use the poisoned well lest it poisons you, lest you poison those that donāt use the well.
And Iād like to remind you that you can do, literally, whatever you want at any time. The only considerations are consequences. You can literally murder the next person you see, in the same way you can just walk off and start your journey. One has consequences of prison lol, but the otherā¦ well, who knows?
This mindset has saved my life in hard times. Where everything felt awful. Walking away from it seemed so much more obvious than staying. Whatās the worst that could happen? Iām happier? Haha. Yep. Time to just start walking. No plan, no direction, just knowing āI can not do this any more and I wonāt be here any more.ā
Youāll be surprised how rapidly thing start becoming good when you leave the bad. Donāt doubt yourself. Donāt be in a rut. Youāll never live otherwise.
Burnout 3 absolutely. Paradise was a great game but itās format shift to open world effectively killed the series. Also made races really repetitive since they always went to the same places and you didnāt have an incentive to explore the rest of the map, which was full of really cool stuff like the quarry and train linesā¦
Anyway Burnout 3 is just the perfection of the classic formula. Shoutouts to Revenge for the traffic check mechanic and the cool new car designs.
kbin.life
Newest