Right! The good old days when the software used to come in a box with several varied width books containing all these Four, and one named Getting Started.
This same set could be easily "transposed" to the contemporary world of web. With all the proper indexing. Why is this "art" "lost" for most of the software :-( ...
BTW, one Excellent incarnation of this documentation art is on the front page right now:
> Why is this "art" "lost" for most of the software.
Before the internet, the printed book was all you really got. That meant the company distributing the software had to hire technical writers who'd work with the software devs to create all of this, send it to an editor, and ultimately get published.
We no longer live in an era where tech companies hire tech writers. Software documentation lacking is something that can and limp along with jira cases and support services sold rather than trying to put in the upfront effort to fix everything.
Now, for open source software, hate to say it but the docs have always been pretty crap. Certainly some stands out (usually when the business model was around providing services on top of open source software), but nobody is really paying anyone and few people really want to do that sort of free labor.
The writers can't do their work without input from the technical side and the time for that is often not avaliable.
I know I've been punished for taking time to push ideas to tech writers. Not only does it slow me down in other places, it often gets swept away as unnecessary changes because upstream Sr techs disagree.
For example, when I modify ssl configs, I alway reference the files with soft-links. This makes it so you don't need to modify the config files and simplifies keeping old and new certs so you can flip back during the overlap period you should be providing to test.
I try to avoid editing production files by hand whenever possible because in my experience it introduces the possibility to create errors.
I rewrote some docs extending alot of areas with example commands showing how to test things, with explanations that fleshed out the previous quick and dirty documentation. I also modified the method from copy and replace certs, edit files, restart service; to copy files, replace or create soft-link, restart service.
Upstream approvers trashed the whole thing because the thought it was unnecessary and disagreed with me about manually editing config files.
The downside to all that was software releases happened once every year (or longer). Which, was it actually all that bad, but let’s not be completely wooed by the green looking grass on the other side. There were long delays between new features or bug fixes.
Yes, the upside of the contemporary on-line software distribution is clear. No question about this. "The good old days" :-) reference was only about the comprehensive and ordered documentation that often used to come with the physically shipped software medium.
I suspect all many documented projects died because people couldn't figure out how to use them. By natural selection, anything that survived the good old days is either obvious or well documented. The C programming language, for example.
> By natural selection, anything that survived the good old days is either obvious or well documented
Or so much better than the competition that people use it in spite of poor documentation. Many things like that also grow a cottage industry of people making documentation and teaching (see React or Rails).
All surnames derived from occupations started at certain point of time. Ancestors of Tailor, Smith, Miller, Fletcher, Fisher, Cooper, etc. had different last names at certain time in past. If a change didn't occur these "occupational" names would not exist.
A change in surname is not necessary, just a transition from no surname to surname, which happened relatively recently in many places, or from explicit parentage descriptions ("X son of Y", etc.) to inherited family names.
Maybe. Often when families immigrated to America they tried to pick a spelling that would allow English speakers to pronounce their name close enough to what they were used to that they would understand they were being called. Sometimes the this was a different English word that had nothing to do with the meaning in the original language. (I suspect the same happens with immigrants elsewhere, but I know my family name is based on getting close to the original sound and that happens to be a word that has a different meaning in English)
I don't know if the original word was a occupation back in the old world or not. (the dialect my family spoke is no longer spoken so it would be difficult to research)
> Often when families immigrated to America they tried to pick a spelling that would allow English speakers to pronounce their name close enough to what they were used to that they would understand they were being called. Sometimes the this was a different English word that had nothing to do with the meaning in the original language.
This is also the naming process for some places in the new world like Cuernavaca in Mexico
So it's very likely it is just a normal thing humans tend to do. Except I don't know much European history so I can't tell if those places got it from England
right, I'm just putting a date on it for anyone wondering about when it happened in English. I have no idea when people got last names in those countries. Also they didn't have different last names before they got these names, they just didn't have last names at all.
Are you a professional [earning most of your money through your art]? Which country do you live in please?
I've only seen the self-curation from community groups. I'm all for collectives but I'm pretty sure the professional artists I know would say it gives off budget/desperate vibes and so it's something you can't afford to do if you aspire to 'make it [big]'.
{I express myself through overuse of parentheses and through runon sentences...}
