I think several here have different expectations of what constitutes "good documentation". Being a Linux sysadmin, I work in FOSS day in, day out, and documentation is always available and clear.
Without knowing, you've hit the nail with the hammer.
Here is why FOSS docs are so nice to you, but proprietary ones are not: audience analysis.
The people who create FOSS documentation are often either the developers themselves, or very early adopters who spend a lot of time with the developers. They have a technical mindset, and will write documentation in that way. You have a very technical mindset, and like me, will probably prefer a well-commented configuration example over a nicely formatted.pdf document with all possible options.
Our local colleges and universities demand documentation in the source. Typically, doxygen is the tool. With doxygen, html, pdf and man documentation can be relatively easily prepared. And the reason it wins my support is that one documents the code while the information is fresh in the mind. Software updates are documented in place, and with one "make" program call,the new revised documentation is created.
In large enterprises, things are different. That's where the professional technical writers come in (yes, that's a full-time job). These folks will come up with a target audience, secondary audience, initial outline for the documentation and (in their minds) well-written content and examples. Since this gets reviewed many times by people who all have an ego telling them that they must make at least some changes in order to show productivity to their bosses, the documentation ends up being a piece of crap. It may be correct, but it usually is a piece of crap.
For example, let's take any routing vendor's documentation. You are looking to configure something as simple as an L3VPN. The easiest way to do this is by getting an example configuration and just change some IP addresses to match your own network, right? Well, the "professionals" think not. They will come up with this:
Step 1: configure an IGP. For more information on how to configure an IGP, see chapter 12, section 3.
Step 2: enable the appropriate interfaces for MPLS. For more information on how to enable interfaces for MPLS, see chapter 2, section 1.
Step 3: create an LSP between the two PE nodes. For more information an how to configure LSPs, see chapter 2, section 10.
Step 4: enable a signaling protocol such as BGP or LDP. For more information on how to configure BGP as an L3VPN signaling protocol, see chapter 10, section 9. For more information on how to configure (targeted) LDP as your L3VPN signaling protocol, see chapter 7, section 1.
Step 5: configure the route-target: set route-target 12345:1. For more information on route-target configuration, see chapter 8, section 2.
Step 6: configure the route-distinguisher: set route-distinguisher 12345:100. For more information on route-distinguisher configuration, see chapter 8, section 3.
And that, my friend, is why commercial documentation sucks a monkey's ass.
BRAVO. Also you forgot jargon and abbreviations without a glossary to describe what it is you mean by the "Gronk" function. The Gronk function, by the way is a fixed up fubar function.
Agreed. I think several here have different expectations of what constitutes "good documentation". Being a Linux sysadmin, I work in FOSS day in, day out, and documentation is always available and clear.
As soon as I dip a toe into proprietary software, I'm met with a stubborn inability to communicate from the publisher. NVIDIA, HP, Microsoft, rank about the same in terms of opacity. Even Red Hat's documentation of their proprietary products are no match for the exact same company's contributions to FOSS documentation.
But then there are other FOSS products that match proprietary for its lousiness in documentation. Ganglia, Puppet, I'm looking at you.
My frustration with Fedora is the locked in attitude to documentation preparation and editing. Some of the grammar stinks, and some of it is just plain missing or two generations late.
Fedora uses software tools (I did not see GIT in there) and a closed team to writing and translating. I did not see much in the way of editing being possible. A much much superior approach, in my opinion would be to use Wordpress or Wikapaedia (or a clone) to allow a community of users to revise the writing and editing of the documentation. All in favor of having Wikapaedia as the documentation management system for FOSS say AYE!!!
The great things google can offer, 1984 saves the children!
(Yes it's good that pedophiles get hurt - But there is a very very bad precedent here...)
I am wondering about this subject of pedophilia. Men enjoy nudes, of women, and some even do the (cough cough) usual to relieve themselves. Are these men perverts if they relieve themselves?
A pedophile may have restraint in that he would never touch a child, but he needs photos of kids in the same way many men need nudes. To fantasize and relieve themselves. I would make eunuchs of people who touch or take the pictures but is there any proof that looking at pictures, obtained by "viewer perverts" is harmful to society? I know possession is illegal. Is looking on the web at such things illegal for the viewer or for the website host? In this latter case, the viewer is not in possession.
A Hamas manual on "Urban Warfare" found by the Israeli Defense Forces makes it unmistakably clear that Hamas desires civilian casualties amongst its own people and encourages its fighters to engage in battles in civilian populated areas in order to draw an Israeli response.
"Where is the U.N. Human Rights Council? Where is Amnesty International? Where is Human Rights Watch? Where is the international media and Middle East pundits. Where are all the lawfare experts? Here is 'Exhibit A' to indict Hamas for war crimes and crimes against humanity by placing the people of Gaza as human shields," said Rabbis Marvin Hier and Abraham Cooper, dean and founder and associate dean of the Simon Wiesenthal Center.
From the IDF Blog:
IDF forces in the Gaza Strip found a Hamas manual on “Urban Warfare,” which belonged to the Shuja’iya Brigade of Hamas’ military wing, the Al-Qassam Brigades. The manual explains how the civilian population can be used against IDF forces and reveals that Hamas knows the IDF is committed to minimizing harm to civilians.
Throughout Operation Protective Edge, Hamas has continuously used the civilian population of Gaza as human shields. The discovery of a Hamas “urban warfare” manual by IDF forces reveals that Hamas’ callous use of the Gazan population was intentional and preplanned.
This Hamas urban warfare manual exposes two truths: (1) The terror group knows full well that the IDF will do what it can to limit civilian casualties. (2) The terror group exploits these efforts by using civilians as human shields against advancing IDF forces.
The Manual:
In a portion entitled “Limiting the Use of Weapons,” the manual explains that:
The soldiers and commanders (of the IDF) must limit their use of weapons and tactics that lead to the harm and unnecessary loss of people and [destruction of] civilian facilities. It is difficult for them to get the most use out of their firearms, especially of supporting fire [e.g. artillery].
Clearly Hamas knows the IDF will limit its use of weapons in order to avoid harming civilians, including refraining from using larger firepower to support for infantry.
The manual goes on to explain that the “presence of civilians are pockets of resistance” that cause three major problems for advancing troops:
(1) Problems with opening fire
(2) Problems in controlling the civilian population during operations and afterward
(3) Assurance of supplying medical care to civilians who need it
Lastly, the manual discusses the benefits for Hamas when civilian homes are destroyed:
The destruction of civilian homes: This increases the hatred of the citizens towards the attackers [the IDF] and increases their gathering [support] around the city defenders (resistance forces[i.e. Hamas]).
It is clear that Hamas actually desires the destruction of homes and civilian infrastructure, knowing it will increase hatred for the IDF and support their fighters.
Why Shuja’iya is Important
It is also of no small importance that this manual belongs to the Shuja’iya Brigade. The IDF fought a major battle in the neighborhood of Shuja’iya, which had been turned into a terrorist stronghold. The discovery of this manual suggests that the destruction in Shuja’iya was always part of Hamas’ plan.
"Where is the U.N. Human Rights Council? Where is Amnesty International? Where is Human Rights Watch? Where is the international media and Middle East pundits. Where are all the lawfare experts? Here is 'Exhibit A' to indict Hamas for war crimes and crimes against humanity by placing the people of Gaza as human shields," said Rabbis Marvin Hier and Abraham Cooper, dean and founder and associate dean of the Simon Wiesenthal Center.
From the IDF Blog:
IDF forces in the Gaza Strip found a Hamas manual on “Urban Warfare,” which belonged to the Shuja’iya Brigade of Hamas’ military wing, the Al-Qassam Brigades. The manual explains how the civilian population can be used against IDF forces and reveals that Hamas knows the IDF is committed to minimizing harm to civilians.
Throughout Operation Protective Edge, Hamas has continuously used the civilian population of Gaza as human shields. The discovery of a Hamas “urban warfare” manual by IDF forces reveals that Hamas’ callous use of the Gazan population was intentional and preplanned.
This Hamas urban warfare manual exposes two truths: (1) The terror group knows full well that the IDF will do what it can to limit civilian casualties. (2) The terror group exploits these efforts by using civilians as human shields against advancing IDF forces.
The Manual:
In a portion entitled “Limiting the Use of Weapons,” the manual explains that:
The soldiers and commanders (of the IDF) must limit their use of weapons and tactics that lead to the harm and unnecessary loss of people and [destruction of] civilian facilities. It is difficult for them to get the most use out of their firearms, especially of supporting fire [e.g. artillery].
Clearly Hamas knows the IDF will limit its use of weapons in order to avoid harming civilians, including refraining from using larger firepower to support for infantry.
The manual goes on to explain that the “presence of civilians are pockets of resistance” that cause three major problems for advancing troops:
(1) Problems with opening fire
(2) Problems in controlling the civilian population during operations and afterward
(3) Assurance of supplying medical care to civilians who need it
Lastly, the manual discusses the benefits for Hamas when civilian homes are destroyed:
The destruction of civilian homes: This increases the hatred of the citizens towards the attackers [the IDF] and increases their gathering [support] around the city defenders (resistance forces[i.e. Hamas]).
It is clear that Hamas actually desires the destruction of homes and civilian infrastructure, knowing it will increase hatred for the IDF and support their fighters.
Re the powerstation. Israel is not dumb, Israel provides Gaza with power, from the Israeli nuclear generators. If they wanted to kill power, they just had to kill connection, a simple switch to off.
Hamas rockets have a 20% failure rate, where they fall back onto their own land. Israel has adamantly denied bombing their distribution system. You decide, Israel or Hamas.
Question to answer. Why has Fatah not joined Hamas? My thoughts are that since the last cease fire, construction, trade, tourism, schools and more have been expanding in Palestine. Standard of living has been increasing, and jobs in Israel have opened up. Money, trade, etc.
I am in Montreal Quebec, and I purchase Lebanese products, because (yes, because) of the co-existence with Israel. That would stop immediately if there was conflict between the two countries. I buy Israeli products too, as one would expect of me as my wife, in-laws, are former Israelis.
Israel has killed almost 800 Palestinians in the past twenty-one days in the Gaza Strip alone; its onslaught continues. The UN estimates that more than 74 percent of those killed are civilians. That is to be expected in a population of 1.8 million where the number of Hamas members is approximately 15,000. Israel does not deny that it killed those Palestinians using modern aerial technology and precise weaponry courtesy of the world’s only superpower. In fact, it does not even deny that they are civilians.
Israel’s propaganda machine, however, insists that these Palestinians wanted to die (“culture of martyrdom”), staged their own death (“telegenically dead”) or were the tragic victims of Hamas’s use of civilian infrastructure for military purposes (“human shielding”). In all instances, the military power is blaming the victims for their own deaths, accusing them of devaluing life and attributing this disregard to cultural bankruptcy. In effect, Israel—along with uncritical mainstream media that unquestionably accept this discourse—dehumanizes Palestinians, deprives them even of their victimhood and legitimizes egregious human rights and legal violations.
This is not the first time. The gruesome images of decapitated children’s bodies and stolen innocence on Gaza’s shores are a dreadful repeat of Israel’s assault on Gaza in November 2012 and winter 2008–09. Not only are the military tactics the same but so too are the public relations efforts and the faulty legal arguments that underpin the attacks. Mainstream media news anchors are inexplicably accepting these arguments as fact.
Below I address five of Israel’s recurring talking points. I hope this proves useful to newsmakers.
1) Israel is exercising its right to self-defense.
As the occupying power of the Gaza Strip, and the Palestinian Territories more broadly, Israel has an obligation and a duty to protect the civilians under its occupation. It governs by military and law enforcement authority to maintain order, protect itself and protect the civilian population under its occupation. It cannot simultaneously occupy the territory, thus usurping the self-governing powers that would otherwise belong to Palestinians, and declare war upon them. These contradictory policies (occupying a land and then declaring war on it) make the Palestinian population doubly vulnerable.
The precarious and unstable conditions in the Gaza Strip from which Palestinians suffer are Israel’s responsibility. Israel argues that it can invoke the right to self-defense under international law as defined in Article 51 of the UN Charter. The International Court of Justice, however, rejected this faulty legal interpretation in its 2004 Advisory Opinion. The ICJ explained that an armed attack that would trigger Article 51 must be attributable to a sovereign state, but the armed attacks by Palestinians emerge from within Israel’s jurisdictional control. Israel
I once worked for a company that wrote web banking software. The laptops/desktops/etc of certain employees had a 'driver' that continually monitored the USB ports. If anything plugged into it that had storage on it but not the proper corporate auth key to connect as an approved storage device? It would automatically send an email to the IT department, immediately shut off the entire USB subsystem in the OS, and it stayed that way until the device was re-imaged (in many cases making the device completely useless). It also got you immediately perp-walked out of the building and freshly unemployed, unless you could immediately give them a reasonable (and provable) explanation as to why it happened.
Now in this case, I suspect that if the bad stick presented itself to the OS as a keyboard/mouse/whatever, it may circumvent that (I say "may" because I don't know if it would be able to dump any non-keyboard/mouse-related data onto the machine w/o presenting itself as storage.)
Either way, if you're that worried about it, then epoxy the USB ports shut (well, except on the phone for obvious reasons...)
Surprise, surprise, surprise, not all computer cases are locked. Had a case of user powering off the computer and rebooting with a live usb drive. Since it was standalone, the host system did not detect this action.
Also had a case of an employee opening up the computer case, unplugging the drive and replugging it into his external USB hardware adapter (cost for adapter $35.00 at NewEgg.ca) Used his laptop to download stuff from that mpw external laptop drive to his laptop, and person could upload stuff too. No, he did not insert stuff on the drive, but we do know he dl'd stuff. t'il by chance an IT guy happened by.
I would hire devs to interface with the ERP. Because when you go to upgrade to the next version [of the ERP], you have a modular thing that you can change pieces of rather than having to pay someone to rewrite the entire thing. If you continue to customize the ERP you're using, you'll be locked in to that specific version and all of its security/stability/functionality problems.
Have you looked at an alternative ERP system? Ive used many that were as functional as Oracle or even more functional, and at less than Oracle's TCO.
That's what Israel tells the world after they bomb schools....
Don't let israel brainwash you!
That's what Israel tells the world after they bomb schools....
Don't let israel brainwash you!
Hello, Mr. Hamas Troll,
The other day when BBC was interviewing a doctor who was inside a hospital in Gaza, in the middle of the interview two Hamas rockets were fired from the 3rd floor of the same hospital
The sounds of the rocket firing was heard clearly, and the doctor himself admitted in that live broadcast that two rockets were fired from the hospital
That broadcast was not sponsored in any way by Israel. It was a BBC broadcast !
That's what Israel tells the world after they bomb schools....
Don't let israel brainwash you!
That's what Israel tells the world after they bomb schools....
Don't let israel brainwash you!
If it was the USA in Israel's situation, would they send knocker bombs or pamphlets or make phone calls. I bet you that the USA would have dropped napalm, and would have just eliminated Gaza.
Want to live with terrorists in your midst, here is a link Here is the funeral of one such terrorist stopped by Israel. The funeral was taking place in Gaza, They failed to remove the suicide belt before the burial.
If you bought the CD/DVD, you are entitled to protect the CD/DVD from scratches and damage by copying to the car's hard disk. This hard disk is integral to your car and is not transferable. Ergo, I believe that there is no need to pay for a second copy of the purchased entertainment.
According to Tesla, it will have as much production capacity as all current li-ion battery factories combined.
The giga does have some meaning, as the factory has a planned production of 35 gigawatt-hours of batteries per year.
This is a great investment, Robotics galore, people only for telephone and emails. And the best part, just when the site gets to be profitable, new technology will come along and make that investment a major flawed decision.
Will this factory battery be able to replace my car's lead-acid wonder? My car's battery has survived 7 subzero winters of -20F and 7 100F summers, and occasionally being drained when we forgot to turn off the headlights.
Not a pyramid scheme, but due to usurious interest rates (19.5% plus late payment penalties that are not considered interest). If the cards were at 6% (bank interest is 2% on savings), debt could be paid down.
" disabling everything that plugs into a wall socket. Most people wouldn't even be able to flush their toilet because urban water supplies largely rely on electric pumps"
Every single water filtration plant has very large diesel generators that can run the place for months without electrical power. And no, a solar flare can not burn out giant motors and generators, all that can be ran easily without the SCADA system. In fact we used to run drills operating the place by hand, as most of the guys that did it from 1940 until 1990 did it mostly by hand.
One problem I see, is tha that the municipal storage tanks would need to be refilled, once fuel was consumed. But to do that, you need to have a way to pump the fuel to the transport trucks, and to ensure the truck can deliver the fuel. Not too sure your idea is possible, except for a short time, perhaps less than a week.
Simple, it's the same people who get into a hissy fit whenever someone posts something that's contrary to their view of the world. The group think on/. is thick, and the site is screaming in decline as noticed by the lack of comments on topics and poor commenting.
Of course it is in decline. University/College/school is out for the summer as students try to earn money to cover the next semester. I just love for profit everything, including education. Wanna buy a masters degree, we have a ghost writer for you, real cheap". Our university has no buildings, ergo, degrees are cheap to come by, and while you are working to pay for that diploma, we'll keep you to busy to write to/.
Where are the well educated? In countries where education is low cost. Almost every country has geniuses that are able to obtain PHD and other degrees. Oh yes, the degrees are in earned in Spanish, French, Portugese, Hebrew, Aisian (Chinese/Japonese/Korean) and yes, English too.
Its time to return most of California to Mexico, and the lands back to the native indians.
Jerusalem and Jordan and the current land of Israel were always inhabited by Jews. For over 100 years Jews were buying up land in that area. There is no way that Israel will tolerate terrorism against it. Hamas has refused to recognize peaceful co-existance. Their charter says to have muslim world domination and death to infidels and Jews. Had Hamas concentrated in building infrastructure, schools, universities, roads, etc, the hundred of millions of dollars poured into cement walls for tunnels was a theft from their citizens.
Israel wants peace. Trade with neighbours would have helped Lebanon,Jordan, Gaza, Palestine, and more to improve the life of all residents. Shame on power blind leaders--only 1 religion allowed, and Christianity is amoungst many excluded.
You want people to adopt electric cars and hybrids in greater numbers sooner? You want to wean the general populace off of fossil fuels? This is how you do it! Of all the complete wastes of money the U.S. government commits, this comparatively speaking would be a drop in the bucket and of great long-term benefit to the entire country. While we're at it how about they sink some money into electric vehicle support infrastructure like rapid charging stations, too?
Whatever increases government net revenue would be the guide for the best solution. Please note, some of that money would come as party donations. Gas, Electric, Nuclear, wind, coal, water, they are all financing one or other political party.
Why think that the governments (fed and state) are going th be in favour of hybrid car subsidies?
Ads and marketing in general have evolved from simple, respectful "hey, try this! It's good" into manipulative nonsense. Few people can see through it and the result has been devastating to them. It has shaped and certainly harmed the culture of the US and even results in violence in some extreme cases where people want things so badly they hurt and kill each other to get it. Though most will disagree exactly when things have gone "too far" few will disagree that they have.
I have always subscribed to yahoo.com @ 20/yr. This last renewal, they rejected my visa payment because they were not equipped to have Visa transfer my payment directly to my provider for approval. And there is no way for anyone to contact yahoo.com. No way, I discovered, and no ombudsman, I could not get my payment processed. SHAME
So now I am getting the same repetitive annoying add from a dating service. I will try the following... Edit my profile and change my age to 12 or 13. Just to stop that repetitious dating stuff. I am of the belief that we need a free from adverts NET NEUTRAL internet. If I pay my ISP for a connection, I expect him to not count the adverts in my download allotment. Fortunately, using Thunderbird, I got rid of most of the stupid adverts.
Set your age to 12 for youtube, twitter, gmail, hotmail, and whatever, and see what happens.
They'll never pass up an opportunity to squeeze more money to fund pet projects back home. Hell, they're already talking about tapping the untouched potential of my 401(k).
Do you pay taxes on services. Get the car repaired and pay for labour and taxes? In most parts of the world, labor is value added and is therefore taxed. Are your phone services taxed?
The point of password reuse is to use an algorithm that you can remember but not someone can guess.
This is not my password but it's an example of how I create one: If I visit a site and it's name is GoogleSucks.com, I will use my "easy" word + the first syllable of the site + a padding word that I use on all sites, Depending on how asinine the password requirements are, the beginning or end of the password will be padded with numbers and symbols, but always the same ones. So Googlesucks.com might be turkeyGootrucking8 and another site like a bank site that I want higher entrophy on will use a different algorithm, so BOA might end up a hard non-englisht word + the passing word, then the company's initials + needed password entrophy, so BOA would end up with namastetruckingBOA8
So when I use sites that want to remember my shipping address or credit card (I never save my credit card number, I don't care how "safe" your site is) I use the harder credentials. I just want to post a comment on the many HuffPo type of sites, easy password all the time. So while each password for each site is unique, effectively the easy password is reused but padded with something unique to the site so that even if the password was stolen it's unusable for any other site.
When a bank's or other stupid organization calls on using a password with a Capital letter, an integer and a minimum of 8 characters, and two adjacent characters not the same, it is recipe for easy hacking. Mathematically, easy.
I protect my passwords by including the wonderful €, and symbols which are on my standard keyboard.
Suggesting she become a homemaker despite her explicit request for career information and knowing nothing about her other than her gender -- yes, almost certainly misogyny.
Homemaker is a career, and it does take certain skillsets that are developed over a lifetime. It's an important career chosen by many women throughout history. Consider what happens if the next generation is not nurtured and educated.
And it is a future proof job - can't outsource child making and rearing, and she has capabilities unique to her sex. (eg: half the potential competition of other career paths) Kids are also an effective retirement plan when raised well.
Even if you don't think it's the best option, it's a valid option, and a noble one.
Chez nous (Canada), women are in construction industries, in taking over the gardening/snow removal businesses, plumbing, motor mechanics, refrigeration systems and electricity. These are skills that will be required for centuries to come.
And while they may be at 80% of the "professional rate", the lifespan for the former is longer, both in age, and in working years, and in pension years.
Among dinosaurs who still use desktop computers, instead of laptops or tablets, I guess.
You're either retarded, or you don't do anything useful with your computer.
Anyone who wants to do anything graphics-intensive would laugh at someone trying to push a laptop on them.
I hate idiots who think laptops are for gaming. They go buy the crappy $200 Walmart bargain, then wonder why it won't play BF4.
For you, a desktop computer is a toy. But for me, with 7 disks, and different applications per disk, and with the amount of coding in differing languages, and my need to use a real keyboard, so as to net get carpal tunnel problems, and with a 23 inch monitor and speed, the laptop is the toy. My smartphone is a current Nexus, and I still need glasses to read the fine fine text.
My smartphone is my voicemail and voice support and my price comparison friend. When I am about to purchase a product at xyz, I do my due dilligence and do price/guarantee comparisons.
Laptops are too flimsy, overheat and are just a device onto which to spill coffee, to use to play with social media and to end-up with another several hundred dollar purchase when the keytops suddenly fall off, or the laptop falls on the floor, breaking the hinge. My tablet (Samsung) for browsing the web, playing free-cell, for some emailing, but not for true work.
Are we assuming all transactions humans do are with merchants?
Naive as hell !
Crappy list of examples, I'm sure there are hundreds of examples: 1) What about if I want to buy your [insert bike or computer or whatever]? 2) Baby sitter? 3) Kid's allowance? 4) Pay some kid kid to mow yard. 5) Underground transactions (illegal stuff)
It already happens in Africa, with cellphone to cellphone transactions. You take some money from the bank which goes to your cellphone account. You spend your cellphone account and get more money. Taxi drivers receive cellphone cash, and visit the bank to convert some of it to cash, but use the cellphone money to buy gas, food, etc.
Why cellphone. Printing money that wears out or is germ laden does not pay. And the cellphone technique limited to small transactions works.
The importance of cash will continue to decline with transactions with merchants, but it will never remotely approach "cashless".
It is coming, particularly for businesses. Cash will still be available for small purchases, but others no.
It could happen two ways. For a fixed fee, a business will arrange for unlimited debit transactions to be processed immediately to their account, with once a day reconciliation. As for credit transactions, there will be no initial change. but later, there will be a merge with debit and credit accounts. Individuals will have a line of credit, and if that is exhausted, the credit card rates will apply after 20 days. Automated payments for taxes, utilities, and other fees will grow in number. And faster checkouts will be needed before this happens. The question to answer is "How fast is it going to occur?"
I think several here have different expectations of what constitutes "good documentation". Being a Linux sysadmin, I work in FOSS day in, day out, and documentation is always available and clear.
Without knowing, you've hit the nail with the hammer.
Here is why FOSS docs are so nice to you, but proprietary ones are not: audience analysis.
The people who create FOSS documentation are often either the developers themselves, or very early adopters who spend a lot of time with the developers. They have a technical mindset, and will write documentation in that way. You have a very technical mindset, and like me, will probably prefer a well-commented configuration example over a nicely formatted .pdf document with all possible options.
Our local colleges and universities demand documentation in the source. Typically, doxygen is the tool. With doxygen, html, pdf and man documentation can be relatively easily prepared. And the reason it wins my support is that one documents the code while the information is fresh in the mind. Software updates are documented in place, and with one "make" program call,the new revised documentation is created.
In large enterprises, things are different. That's where the professional technical writers come in (yes, that's a full-time job). These folks will come up with a target audience, secondary audience, initial outline for the documentation and (in their minds) well-written content and examples. Since this gets reviewed many times by people who all have an ego telling them that they must make at least some changes in order to show productivity to their bosses, the documentation ends up being a piece of crap. It may be correct, but it usually is a piece of crap.
For example, let's take any routing vendor's documentation. You are looking to configure something as simple as an L3VPN. The easiest way to do this is by getting an example configuration and just change some IP addresses to match your own network, right? Well, the "professionals" think not. They will come up with this:
Step 1: configure an IGP. For more information on how to configure an IGP, see chapter 12, section 3.
Step 2: enable the appropriate interfaces for MPLS. For more information on how to enable interfaces for MPLS, see chapter 2, section 1.
Step 3: create an LSP between the two PE nodes. For more information an how to configure LSPs, see chapter 2, section 10.
Step 4: enable a signaling protocol such as BGP or LDP. For more information on how to configure BGP as an L3VPN signaling protocol, see chapter 10, section 9. For more information on how to configure (targeted) LDP as your L3VPN signaling protocol, see chapter 7, section 1.
Step 5: configure the route-target: set route-target 12345:1. For more information on route-target configuration, see chapter 8, section 2.
Step 6: configure the route-distinguisher: set route-distinguisher 12345:100. For more information on route-distinguisher configuration, see chapter 8, section 3.
And that, my friend, is why commercial documentation sucks a monkey's ass.
BRAVO. Also you forgot jargon and abbreviations without a glossary to describe what it is you mean by the "Gronk" function. The Gronk function, by the way is a fixed up fubar function.
Agreed. I think several here have different expectations of what constitutes "good documentation". Being a Linux sysadmin, I work in FOSS day in, day out, and documentation is always available and clear.
As soon as I dip a toe into proprietary software, I'm met with a stubborn inability to communicate from the publisher. NVIDIA, HP, Microsoft, rank about the same in terms of opacity. Even Red Hat's documentation of their proprietary products are no match for the exact same company's contributions to FOSS documentation.
But then there are other FOSS products that match proprietary for its lousiness in documentation. Ganglia, Puppet, I'm looking at you.
My frustration with Fedora is the locked in attitude to documentation preparation and editing. Some of the grammar stinks, and some of it is just plain missing or two generations late.
Fedora uses software tools (I did not see GIT in there) and a closed team to writing and translating. I did not see much in the way of editing being possible. A much much superior approach, in my opinion would be to use Wordpress or Wikapaedia (or a clone) to allow a community of users to revise the writing and editing of the documentation.
All in favor of having Wikapaedia as the documentation management system for FOSS say AYE!!!
Aye (from Montreal)
The great things google can offer, 1984 saves the children!
(Yes it's good that pedophiles get hurt - But there is a very very bad precedent here...)
I am wondering about this subject of pedophilia. Men enjoy nudes, of women, and some even do the (cough cough) usual to relieve themselves. Are these men perverts if they relieve themselves?
A pedophile may have restraint in that he would never touch a child, but he needs photos of kids in the same way many men need nudes. To fantasize and relieve themselves. I would make eunuchs of people who touch or take the pictures but is there any proof that looking at pictures, obtained by "viewer perverts" is harmful to society? I know possession is illegal. Is looking on the web at such things illegal for the viewer or for the website host? In this latter case, the viewer is not in possession.
One response
https://www.kintera.com/accoun...
A Hamas manual on "Urban Warfare" found by the Israeli Defense Forces makes it unmistakably clear that Hamas desires civilian casualties amongst its own people and encourages its fighters to engage in battles in civilian populated areas in order to draw an Israeli response.
"Where is the U.N. Human Rights Council? Where is Amnesty International? Where is Human Rights Watch? Where is the international media and Middle East pundits. Where are all the lawfare experts? Here is 'Exhibit A' to indict Hamas for war crimes and crimes against humanity by placing the people of Gaza as human shields," said Rabbis Marvin Hier and Abraham Cooper, dean and founder and associate dean of the Simon Wiesenthal Center.
From the IDF Blog:
IDF forces in the Gaza Strip found a Hamas manual on “Urban Warfare,” which belonged to the Shuja’iya Brigade of Hamas’ military wing, the Al-Qassam Brigades. The manual explains how the civilian population can be used against IDF forces and reveals that Hamas knows the IDF is committed to minimizing harm to civilians.
Throughout Operation Protective Edge, Hamas has continuously used the civilian population of Gaza as human shields. The discovery of a Hamas “urban warfare” manual by IDF forces reveals that Hamas’ callous use of the Gazan population was intentional and preplanned.
This Hamas urban warfare manual exposes two truths: (1) The terror group knows full well that the IDF will do what it can to limit civilian casualties. (2) The terror group exploits these efforts by using civilians as human shields against advancing IDF forces.
The Manual:
In a portion entitled “Limiting the Use of Weapons,” the manual explains that:
The soldiers and commanders (of the IDF) must limit their use of weapons and tactics that lead to the harm and unnecessary loss of people and [destruction of] civilian facilities. It is difficult for them to get the most use out of their firearms, especially of supporting fire [e.g. artillery].
Clearly Hamas knows the IDF will limit its use of weapons in order to avoid harming civilians, including refraining from using larger firepower to support for infantry.
The manual goes on to explain that the “presence of civilians are pockets of resistance” that cause three major problems for advancing troops:
(1) Problems with opening fire
(2) Problems in controlling the civilian population during operations and afterward
(3) Assurance of supplying medical care to civilians who need it
Lastly, the manual discusses the benefits for Hamas when civilian homes are destroyed:
The destruction of civilian homes: This increases the hatred of the citizens towards the attackers [the IDF] and increases their gathering [support] around the city defenders (resistance forces[i.e. Hamas]).
It is clear that Hamas actually desires the destruction of homes and civilian infrastructure, knowing it will increase hatred for the IDF and support their fighters.
Why Shuja’iya is Important
It is also of no small importance that this manual belongs to the Shuja’iya Brigade. The IDF fought a major battle in the neighborhood of Shuja’iya, which had been turned into a terrorist stronghold. The discovery of this manual suggests that the destruction in Shuja’iya was always part of Hamas’ plan.
"Where is the U.N. Human Rights Council? Where is Amnesty International? Where is Human Rights Watch? Where is the international media and Middle East pundits. Where are all the lawfare experts? Here is 'Exhibit A' to indict Hamas for war crimes and crimes against humanity by placing the people of Gaza as human shields," said Rabbis Marvin Hier and Abraham Cooper, dean and founder and associate dean of the Simon Wiesenthal Center.
From the IDF Blog:
IDF forces in the Gaza Strip found a Hamas manual on “Urban Warfare,” which belonged to the Shuja’iya Brigade of Hamas’ military wing, the Al-Qassam Brigades. The manual explains how the civilian population can be used against IDF forces and reveals that Hamas knows the IDF is committed to minimizing harm to civilians.
Throughout Operation Protective Edge, Hamas has continuously used the civilian population of Gaza as human shields. The discovery of a Hamas “urban warfare” manual by IDF forces reveals that Hamas’ callous use of the Gazan population was intentional and preplanned.
This Hamas urban warfare manual exposes two truths: (1) The terror group knows full well that the IDF will do what it can to limit civilian casualties. (2) The terror group exploits these efforts by using civilians as human shields against advancing IDF forces.
The Manual:
In a portion entitled “Limiting the Use of Weapons,” the manual explains that:
The soldiers and commanders (of the IDF) must limit their use of weapons and tactics that lead to the harm and unnecessary loss of people and [destruction of] civilian facilities. It is difficult for them to get the most use out of their firearms, especially of supporting fire [e.g. artillery].
Clearly Hamas knows the IDF will limit its use of weapons in order to avoid harming civilians, including refraining from using larger firepower to support for infantry.
The manual goes on to explain that the “presence of civilians are pockets of resistance” that cause three major problems for advancing troops:
(1) Problems with opening fire
(2) Problems in controlling the civilian population during operations and afterward
(3) Assurance of supplying medical care to civilians who need it
Lastly, the manual discusses the benefits for Hamas when civilian homes are destroyed:
The destruction of civilian homes: This increases the hatred of the citizens towards the attackers [the IDF] and increases their gathering [support] around the city defenders (resistance forces[i.e. Hamas]).
It is clear that Hamas actually desires the destruction of homes and civilian infrastructure, knowing it will increase hatred for the IDF and support their fighters.
https://www.kintera.com/accoun...
Re the powerstation.
Israel is not dumb, Israel provides Gaza with power, from the Israeli nuclear generators. If they wanted to kill power, they just had to kill connection, a simple switch to off.
Hamas rockets have a 20% failure rate, where they fall back onto their own land. Israel has adamantly denied bombing their distribution system.
You decide, Israel or Hamas.
Question to answer. Why has Fatah not joined Hamas? My thoughts are that since the last cease fire, construction, trade, tourism, schools and more have been expanding in Palestine. Standard of living has been increasing, and jobs in Israel have opened up. Money, trade, etc.
I am in Montreal Quebec, and I purchase Lebanese products, because (yes, because) of the co-existence with Israel. That would stop immediately if there was conflict between the two countries. I buy Israeli products too, as one would expect of me as my wife, in-laws, are former Israelis.
Israel claims that it is merely exercising its right to self-defense and that Gaza is no longer occupied. Here’s what you need to know about these talking points and more.
Israel has killed almost 800 Palestinians in the past twenty-one days in the Gaza Strip alone; its onslaught continues. The UN estimates that more than 74 percent of those killed are civilians. That is to be expected in a population of 1.8 million where the number of Hamas members is approximately 15,000. Israel does not deny that it killed those Palestinians using modern aerial technology and precise weaponry courtesy of the world’s only superpower. In fact, it does not even deny that they are civilians.
Israel’s propaganda machine, however, insists that these Palestinians wanted to die (“culture of martyrdom”), staged their own death (“telegenically dead”) or were the tragic victims of Hamas’s use of civilian infrastructure for military purposes (“human shielding”). In all instances, the military power is blaming the victims for their own deaths, accusing them of devaluing life and attributing this disregard to cultural bankruptcy. In effect, Israel—along with uncritical mainstream media that unquestionably accept this discourse—dehumanizes Palestinians, deprives them even of their victimhood and legitimizes egregious human rights and legal violations.
This is not the first time. The gruesome images of decapitated children’s bodies and stolen innocence on Gaza’s shores are a dreadful repeat of Israel’s assault on Gaza in November 2012 and winter 2008–09. Not only are the military tactics the same but so too are the public relations efforts and the faulty legal arguments that underpin the attacks. Mainstream media news anchors are inexplicably accepting these arguments as fact.
Below I address five of Israel’s recurring talking points. I hope this proves useful to newsmakers.
1) Israel is exercising its right to self-defense.
As the occupying power of the Gaza Strip, and the Palestinian Territories more broadly, Israel has an obligation and a duty to protect the civilians under its occupation. It governs by military and law enforcement authority to maintain order, protect itself and protect the civilian population under its occupation. It cannot simultaneously occupy the territory, thus usurping the self-governing powers that would otherwise belong to Palestinians, and declare war upon them. These contradictory policies (occupying a land and then declaring war on it) make the Palestinian population doubly vulnerable.
The precarious and unstable conditions in the Gaza Strip from which Palestinians suffer are Israel’s responsibility. Israel argues that it can invoke the right to self-defense under international law as defined in Article 51 of the UN Charter. The International Court of Justice, however, rejected this faulty legal interpretation in its 2004 Advisory Opinion. The ICJ explained that an armed attack that would trigger Article 51 must be attributable to a sovereign state, but the armed attacks by Palestinians emerge from within Israel’s jurisdictional control. Israel
Depends.
I once worked for a company that wrote web banking software. The laptops/desktops/etc of certain employees had a 'driver' that continually monitored the USB ports. If anything plugged into it that had storage on it but not the proper corporate auth key to connect as an approved storage device? It would automatically send an email to the IT department, immediately shut off the entire USB subsystem in the OS, and it stayed that way until the device was re-imaged (in many cases making the device completely useless). It also got you immediately perp-walked out of the building and freshly unemployed, unless you could immediately give them a reasonable (and provable) explanation as to why it happened.
Now in this case, I suspect that if the bad stick presented itself to the OS as a keyboard/mouse/whatever, it may circumvent that (I say "may" because I don't know if it would be able to dump any non-keyboard/mouse-related data onto the machine w/o presenting itself as storage.)
Either way, if you're that worried about it, then epoxy the USB ports shut (well, except on the phone for obvious reasons...)
Surprise, surprise, surprise, not all computer cases are locked. Had a case of user powering off the computer and rebooting with a live usb drive. Since it was standalone, the host system did not detect this action.
Also had a case of an employee opening up the computer case, unplugging the drive and replugging it into his external USB hardware adapter (cost for adapter $35.00 at NewEgg.ca) Used his laptop to download stuff from that mpw external laptop drive to his laptop, and person could upload stuff too. No, he did not insert stuff on the drive, but we do know he dl'd stuff. t'il by chance an IT guy happened by.
I would hire devs to interface with the ERP. Because when you go to upgrade to the next version [of the ERP], you have a modular thing that you can change pieces of rather than having to pay someone to rewrite the entire thing. If you continue to customize the ERP you're using, you'll be locked in to that specific version and all of its security/stability/functionality problems.
Have you looked at an alternative ERP system? Ive used many that were as functional as Oracle or even more functional, and at less than Oracle's TCO.
That's what Israel tells the world after they bomb schools ....
Don't let israel brainwash you!
That's what Israel tells the world after they bomb schools ....
Don't let israel brainwash you!
Hello, Mr. Hamas Troll,
The other day when BBC was interviewing a doctor who was inside a hospital in Gaza, in the middle of the interview two Hamas rockets were fired from the 3rd floor of the same hospital
The sounds of the rocket firing was heard clearly, and the doctor himself admitted in that live broadcast that two rockets were fired from the hospital
That broadcast was not sponsored in any way by Israel. It was a BBC broadcast !
That's what Israel tells the world after they bomb schools ....
Don't let israel brainwash you!
That's what Israel tells the world after they bomb schools ....
Don't let israel brainwash you!
If it was the USA in Israel's situation, would they send knocker bombs or pamphlets or make phone calls. I bet you that the USA would have dropped napalm, and would have just eliminated Gaza.
Want to live with terrorists in your midst, here is a link Here is the funeral of one such terrorist stopped by Israel. The funeral was taking place in Gaza, They failed to remove the suicide belt before the burial.
https://www.youtube.com/watch?...
Time Shifting? Worked for the VCR.
If you bought the CD/DVD, you are entitled to protect the CD/DVD from scratches and damage by copying to the car's hard disk. This hard disk is integral to your car and is not transferable. Ergo, I believe that there is no need to pay for a second copy of the purchased entertainment.
This is another unwarranted grab
According to Tesla, it will have as much production capacity as all current li-ion battery factories combined.
The giga does have some meaning, as the factory has a planned production of 35 gigawatt-hours of batteries per year.
This is a great investment, Robotics galore, people only for telephone and emails. And the best part, just when the site gets to be profitable, new technology will come along and make that investment a major flawed decision.
Will this factory battery be able to replace my car's lead-acid wonder? My car's battery has survived 7 subzero winters of -20F and 7 100F summers, and occasionally being drained when we forgot to turn off the headlights.
Not a pyramid scheme, but due to usurious interest rates (19.5% plus late payment penalties that are not considered interest). If the cards were at 6% (bank interest is 2% on savings), debt could be paid down.
" disabling everything that plugs into a wall socket. Most people wouldn't even be able to flush their toilet because urban water supplies largely rely on electric pumps"
Every single water filtration plant has very large diesel generators that can run the place for months without electrical power. And no, a solar flare can not burn out giant motors and generators, all that can be ran easily without the SCADA system. In fact we used to run drills operating the place by hand, as most of the guys that did it from 1940 until 1990 did it mostly by hand.
One problem I see, is tha that the municipal storage tanks would need to be refilled, once fuel was consumed. But to do that, you need to have a way to pump the fuel to the transport trucks, and to ensure the truck can deliver the fuel. Not too sure your idea is possible, except for a short time, perhaps less than a week.
Simple, it's the same people who get into a hissy fit whenever someone posts something that's contrary to their view of the world. The group think on /. is thick, and the site is screaming in decline as noticed by the lack of comments on topics and poor commenting.
Of course it is in decline. University/College/school is out for the summer as students try to earn money to cover the next semester. I just love for profit everything, including education. Wanna buy a masters degree, we have a ghost writer for you, real cheap". Our university has no buildings, ergo, degrees are cheap to come by, and while you are working to pay for that diploma, we'll keep you to busy to write to /.
Where are the well educated? In countries where education is low cost. Almost every country has geniuses that are able to obtain PHD and other degrees. Oh yes, the degrees are in earned in Spanish, French, Portugese, Hebrew, Aisian (Chinese/Japonese/Korean) and yes, English too.
Its time to return most of California to Mexico, and the lands back to the native indians.
Jerusalem and Jordan and the current land of Israel were always inhabited by Jews. For over 100 years Jews were buying up land in that area. There is no way that Israel will tolerate terrorism against it.
Hamas has refused to recognize peaceful co-existance. Their charter says to have muslim world domination and death to infidels and Jews. Had Hamas concentrated in building infrastructure, schools, universities, roads, etc, the hundred of millions of dollars poured into cement walls for tunnels was a theft from their citizens.
Israel wants peace. Trade with neighbours would have helped Lebanon,Jordan, Gaza, Palestine, and more to improve the life of all residents. Shame on power blind leaders--only 1 religion allowed, and Christianity is amoungst many excluded.
You want people to adopt electric cars and hybrids in greater numbers sooner? You want to wean the general populace off of fossil fuels? This is how you do it! Of all the complete wastes of money the U.S. government commits, this comparatively speaking would be a drop in the bucket and of great long-term benefit to the entire country. While we're at it how about they sink some money into electric vehicle support infrastructure like rapid charging stations, too?
Whatever increases government net revenue would be the guide for the best solution. Please note, some of that money would come as party donations. Gas, Electric, Nuclear, wind, coal, water, they are all financing one or other political party.
Why think that the governments (fed and state) are going th be in favour of hybrid car subsidies?
Ads and marketing in general have evolved from simple, respectful "hey, try this! It's good" into manipulative nonsense. Few people can see through it and the result has been devastating to them. It has shaped and certainly harmed the culture of the US and even results in violence in some extreme cases where people want things so badly they hurt and kill each other to get it. Though most will disagree exactly when things have gone "too far" few will disagree that they have.
I have always subscribed to yahoo.com @ 20/yr. This last renewal, they rejected my visa payment because they were not equipped to have Visa transfer my payment directly to my provider for approval. And there is no way for anyone to contact yahoo.com. No way, I discovered, and no ombudsman, I could not get my payment processed. SHAME
So now I am getting the same repetitive annoying add from a dating service. I will try the following... Edit my profile and change my age to 12 or 13. Just to stop that repetitious dating stuff. I am of the belief that we need a free from adverts NET NEUTRAL internet. If I pay my ISP for a connection, I expect him to not count the adverts in my download allotment. Fortunately, using Thunderbird, I got rid of most of the stupid adverts.
Set your age to 12 for youtube, twitter, gmail, hotmail, and whatever, and see what happens.
They'll never pass up an opportunity to squeeze more money to fund pet projects back home. Hell, they're already talking about tapping the untouched potential of my 401(k).
Do you pay taxes on services. Get the car repaired and pay for labour and taxes? In most parts of the world, labor is value added and is therefore taxed. Are your phone services taxed?
The point of password reuse is to use an algorithm that you can remember but not someone can guess.
This is not my password but it's an example of how I create one:
If I visit a site and it's name is GoogleSucks.com, I will use my "easy" word + the first syllable of the site + a padding word that I use on all sites, Depending on how asinine the password requirements are, the beginning or end of the password will be padded with numbers and symbols, but always the same ones.
So Googlesucks.com might be turkeyGootrucking8
and another site like a bank site that I want higher entrophy on will use a different algorithm, so BOA might end up a hard non-englisht word + the passing word, then the company's initials + needed password entrophy, so BOA would end up with namastetruckingBOA8
So when I use sites that want to remember my shipping address or credit card (I never save my credit card number, I don't care how "safe" your site is) I use the harder credentials. I just want to post a comment on the many HuffPo type of sites, easy password all the time. So while each password for each site is unique, effectively the easy password is reused but padded with something unique to the site so that even if the password was stolen it's unusable for any other site.
When a bank's or other stupid organization calls on using a password with a Capital letter, an integer and a minimum of 8 characters, and two adjacent characters not the same, it is recipe for easy hacking. Mathematically, easy.
I protect my passwords by including the wonderful €, and symbols which are on my standard keyboard.
yours
sekalf nroc
(read backwords)
Suggesting she become a homemaker despite her explicit request for career information and knowing nothing about her other than her gender -- yes, almost certainly misogyny.
Homemaker is a career, and it does take certain skillsets that are developed over a lifetime. It's an important career chosen by many women throughout history. Consider what happens if the next generation is not nurtured and educated.
And it is a future proof job - can't outsource child making and rearing, and she has capabilities unique to her sex. (eg: half the potential competition of other career paths) Kids are also an effective retirement plan when raised well.
Even if you don't think it's the best option, it's a valid option, and a noble one.
Chez nous (Canada), women are in construction industries, in taking over the gardening/snow removal businesses, plumbing, motor mechanics, refrigeration systems and electricity. These are skills that will be required for centuries to come.
And while they may be at 80% of the "professional rate", the lifespan for the former is longer, both in age, and in working years, and in pension years.
Among dinosaurs who still use desktop computers, instead of laptops or tablets, I guess.
You're either retarded, or you don't do anything useful with your computer.
Anyone who wants to do anything graphics-intensive would laugh at someone trying to push a laptop on them.
I hate idiots who think laptops are for gaming. They go buy the crappy $200 Walmart bargain, then wonder why it won't play BF4.
For you, a desktop computer is a toy. But for me, with 7 disks, and different applications per disk, and with the amount of coding in differing languages, and my need to use a real keyboard, so as to net get carpal tunnel problems, and with a 23 inch monitor and speed, the laptop is the toy. My smartphone is a current Nexus, and I still need glasses to read the fine fine text.
My smartphone is my voicemail and voice support and my price comparison friend. When I am about to purchase a product at xyz, I do my due dilligence and do price/guarantee comparisons.
Laptops are too flimsy, overheat and are just a device onto which to spill coffee, to use to play with social media and to end-up with another several hundred dollar purchase when the keytops suddenly fall off, or the laptop falls on the floor, breaking the hinge. My tablet (Samsung) for browsing the web, playing free-cell, for some emailing, but not for true work.
Are we assuming all transactions humans do are with merchants?
Naive as hell !
Crappy list of examples, I'm sure there are hundreds of examples:
1) What about if I want to buy your [insert bike or computer or whatever]?
2) Baby sitter?
3) Kid's allowance?
4) Pay some kid kid to mow yard.
5) Underground transactions (illegal stuff)
It already happens in Africa, with cellphone to cellphone transactions. You take some money from the bank which goes to your cellphone account. You spend your cellphone account and get more money. Taxi drivers receive cellphone cash, and visit the bank to convert some of it to cash, but use the cellphone money to buy gas, food, etc.
Why cellphone. Printing money that wears out or is germ laden does not pay. And the cellphone technique limited to small transactions works.
The importance of cash will continue to decline with transactions with merchants, but it will never remotely approach "cashless".
Good luck everybody
It is coming, particularly for businesses. Cash will still be available for small purchases, but others no.
It could happen two ways. For a fixed fee, a business will arrange for unlimited debit transactions to be processed immediately to their account, with once a day reconciliation. As for credit transactions, there will be no initial change. but later, there will be a merge with debit and credit accounts. Individuals will have a line of credit, and if that is exhausted, the credit card rates will apply after 20 days.
Automated payments for taxes, utilities, and other fees will grow in number. And faster checkouts will be needed before this happens.
The question to answer is "How fast is it going to occur?"