Michael Meeks Says OO.o Project is "Profoundly Sick"
unassimilatible writes "Michael Meeks, who works full time developing OpenOffice, writes in his blog that the project is 'profoundly sick.' 'In a healthy project we would expect to see a large number of volunteer developers involved, in addition — we would expect to see a large number of peer companies contributing to the common code pool; we do not see this in OpenOffice.org. Indeed, quite the opposite we appear to have the lowest number of active developers on OO.o since records began: 24, this contrasts negatively with Linux's recent low of 160+. Even spun in the most positive way, OO.o is at best stagnating from a development perspective.'"
Sun wants give the impression of making the software open but at the same time they need tight control over the copyright so that they can continue to sell Star Office.
The code is notoriously difficult to work with and the the owners of the copyright use this to limit the number of players.
http://michaelsmith.id.au
What more do you want them to add.
The rest of the stuff Microsoft has, no one cares about enough to add it.
I am always doing that which I can not do, in order that I may learn how to do it. - Pablo Picasso
No one can compete with M$ for bloatware and useless feature exploits... so why try?
I'm of the somewhat biased opinion that if an app gracefully does what it's supposed to do, it's done.
OO does this, in my experience. Why try to feature-add anything but security improvements?
I think it's just not that interesting and/or rewarding to work on an office package, especially one of Oo.o's complexity, for no monetary reward, especially if you have to also deal with the politics of getting it approved by Sun. If I had an itch to tinker with something like this, I'd probably write my own from scratch.
Ever since Open Office 3.0, I've been able to completely move away from MS Office 2003. I can create word documents that look exactly the same in MS Word 2003, like they do in OO 3.0. Now I can easily exchange documents between coworkers and they have no idea I'm using OO.
I work in aweful world of end-user IT for small businesses. These people are INCREDIBLY picky about how their word, excel, etc documents look. They are also incredibly slow at learning how to use office software. Switching these people from MS Office to OO is nearly impossible. People HATE HATE HATE software with a different interface. Most Office 2003 customers won't touch office 2007 for that exact reason. If OO were improved to the point that it could simulate MS Office so people could easily switch over, OO could take over. I think replacing MS Office with OO is one of the Big Steps linux needs to take to push windows off the desktop.
Outdoor digital photography, mostly in New Engl
But as a word processor and a spreadsheet I find them irritating and clunky to use. I vastly prefer to use Abiword for anything where I don't care whether or not I can work with MS Office format files. And I prefer gnumeric for a spreadsheet.
I don't like Office. I don't like how it's all one big gigantic tool. I want separate tools that I can pull out and replace if something better comes along.
OpenDocument plus things like Abiword and gnumeric are what I want.
Need a Python, C++, Unix, Linux develop
The statistics in the article are interesting, but its conclusion isn't:
Anyone who has been following the project knows what's up. It's just sad that OO.o gave people the impression that other office projects (which could have flourished in the time people were using OO.o) weren't very important. I'm looking at Gnome Office and KOffice.
I almost never use OO.o, though, because I do almost everything in Google Docs or Latex.
p.s. Of course, Meeks is promoting Novell's Go-oo, so people can claim he has too much bias to be an accepted critic.
Put identity in the browser.
Like so many Open Source projects, it's not easy to get involved. It's telling about the complexity of a project that only a handful of people in the world bother to tip-toe through the minefield. Open source projects don't want people who can write code, they want people who can setup build environments and navigate a complex political environment.
At a job I wouldn't need to spend so much time setting up a build environment, there would already be a dozen people who have already figured out even the most intricate details of it. The person whose project it is should have fairly detailed information on setting up a build environment for their project. Open source projects tend to go with a "figure it out yourself" philosophy bragging that it's a rite of passage, but then they wonder why nobody is contributing.
Maybe I'd contribute to OpenOffice.org, but I've already got a mental block realizing that figuring out how to get involved would be at least a week long process. As luck would have it, I also have a week's worth of sleep debt and I already know how to fix that problem.
Do users really need an open source desktop suite when they can meet their needs using a server based suite? Broadband is cheap.
But it's not ubiquitous. For some of us, broadband access is not available at work.
In addition, in some cases, what we are working on needs to be kept secure and not broadcast over broadband.
The ability to pull out a laptop and do real work, without having to try to connect to a server to gain access to productivity tools, is valuable to alot of users
I'm a consultant - I convert gibberish into cash-flow.
This is an interesting issue - I develop an open source program, and it has the main features, is reasonably stable, and so in my mind is finished. There are other features I could add, but how useful they would actually be is debatable. I think this is somewhat similar to the state of openoffice, at the moment. So, what does one do in this state? (Admittedly, I have plenty of bugfixing and stuff to do, so I'm not out of work yet, but you get the idea)
-- All your booze are belong to us.
OOo is quite healthy. However, Novell seems to be profoundly sick: They arent even keep their employees in line.
This isnt the first time Michael Meeks is ranting mindlessly in a misguided attempt to promote Novells private fork (which has problems so big that the official OOo inconveniences are just laughable).
Michael Meeks isnt the only one doing this negative PR for Open Source: Greg KHs bitching about Ubuntu just hits the same chord.
One has to wonder if the Microsoft-Novell Deal was just a bribe to the Novell leadership to refrain from enforcing discipline among their devs. Either that, or its just incompetence.
Yes.
Do users really need an open source desktop suite when they can meet their needs using a server based suite?
I don't like being beholden to an always-on internet connection, availability, and continued business success of a remote host than I like being beholden to Microsoft's dedication to backwards compatibility. I want an office suite and a document format that I'll be able to use for 10 years, or 20.
Nearly every paragraph in the "article" begins with a disclaimer that the data (and/or the analysis) are flawed/biased/incomplete/not useful/meaningless!
Wow. Gotta do some quotes:
Firstly - the data is dirty
Nice
Thus it is possible that there is at least somewhat wider contribution than shown
More than possible
This graph is more meaningless than it might first appear
So, why are you basing are fairly hefty part of your argument on it? If it's meaningless, why is it even included?
So the data is not that useful.
No kidding
Is it more useful to look at an individual to see if they are contributing something ?
I dunno. You asked the question. Is it?
Why one hundred ? why not ?
It is clear that the number of active contributors Sun brings to the project is continuing to shrink
Crystal clear.
Novell's up-stream contribution appears small in comparison with the fifteen engineers we have working on OO.o. This has perhaps
Yeah, expand on that conjecture
So, it should be clear that OO.o is a profoundly sick project
Clear? Clear based on all those assertions they made about their data being dodgy? Yeah, umm, ok.
I'm sorry, but this is article is very hard to take seriously.
Seriously, as is OpenOffice.org is slick, very usable, I love it.
If those 24 developers can continue to right filters for new file formats (24 of them should be able to handle that), make bug fixes, and make the occasional improvement here and there I say great!
OpenOffice.org does not need a rewrite from the ground up every six months to two years.
Seriously, the guys from Neo Office don't have near the funding or man power of the core OpenOffice.org team, look what they've accomplished on "Macing it" (Macking it?).
Between Neo Office and Go-oo making fixes that the upstream developers don't take, I would say there's some FUD going around and there's more people interested in developing for OpenOffice.org than Sun lets on. I'm thinking this may be the first artificial rublings to justify dumping the project sometime in the near future since it's not profitable and hasn't been a big enough thorn in the MS side.
The preceding post was not a Slashvertisement.
I would bet that as projects grow, fewer new developers join -- unless the complexity is managed.
Open Office is starting to feel like X11. It hard to even build let alone modify let alone test. It is a very old code base and it shows.
There is another issue as well I think. It is typically an application "end-point." Projects like Apache, PostgreSQL, PHP, etc. are foundations for other projects. People use them and contribute because they are interested in their own project and they fix or add features to the open source foundations to that end. The primary self interest is their project not PHP or PostgreSQL, but the open source foundations benefit regardless.
With OpenOffice.Org, there is no individualized primary self interest. If I add something to OpenOffice.Org, I only add it because I want it. With the code base as big and complex as it is, I'd have to want it quite badly. I can't think of a feature I need that much or a reason to do all the work to add it. OpenOffice.Org is pretty good as is, what does it need?
Well, using the desktop suite means that you fully control the access to your documents. On the other hand, a "server-based suite" like Google's forces you to relinquish the control of your documents to a third party, which means that you explicitly give vital information on your business to an external party subject to the control of a foreign country. Having economic espionage fresh in the collective memory, including ECHELON, that is a very dumb thing to do.
So yes, users do really need an open source desktop suite, no matter how cheap broadband is at the moment. It's all about control.
Slashdot, fix your code or at least hire someone who is competent at it to do it for you.
There are many things that would float my boat project wise in IT , working on a word processor or spreadsheet isn't one of them.
Easy. All they have to do is refuse to take contributions from the rest of the community. Kohei's solver module is a case in point. He had a fully functional solver, and what did Sun do? They wrote their own.
XML is like violence. If it doesn't solve the problem, use more.
How can Sun control an open source project?
Name recognition, and the time investment in becoming the maintainer of a codebase of this size.
Its not like people are going to be rolling much OO code into their own projects - which is where the GPL licensing breaks down. The cost (giving up your entire codebase) is probably "high" when its likely a small fraction of OO code that is wanted (say some paragraph breaking logic).
OpenOffice.org software is under the GNU Lesser General Public License version 3, which allows it to be combined with proprietary software. I don't see how use of LGPL modules in your code requires "giving up your entire codebase", unless perhaps you're on a platform that requires code signing and forbids end users to sign their own compiled apps.
Could someone please give me a quick comparison between OOo and MS Office?
Here you go: OpenOffice.org has every feature that any practical user would ever want or need. Microsoft Office has these, too, but it also has the ability to generate charts in seventeen dimensions, which for some reason is the one feature absolutely essential to whoever you happen to be trading documents with.
Tomato wedge sperm darts that are Republican.
Sun requires commits be dual-licensed so that Sun can use the code in the commercial version, Star Office. That's how they control
Of course, anyone can fork, and they have. Novell has Go-oo (which Meeks is silently promoting in this article), IBM has Symphony, and there's NeoOffice for Mac.
Nothing was stopping anyone from forking XFree86, either, and they did. Xorg lives on and XFree86 is for all intents and purposes dead.
Sun is going to control OO.o right into the grave.
Put identity in the browser.
I am not a programmer, but I would probably go for something that's entirely web based, but that can also be used offline.
Like you can in MSO2007 with the "Office Live!" add ins?
I only please one person per day. Today is not your day. Tomorrow isn't looking good either. - Scott Adams
For a while, I used OO mostly to assuage my guilt at using Office illicitly.
Then I found out that OO has a major advantage: internationalization for countries that just aren't within Microsoft's marketing strategy. As a (foreign) person working in Mongolia, the relatively basic addition of international spelling packs, particularly for Mongolian, has been a lifesaver - and though I haven't used it, there's a Mongolian localization for the entire suite that I think would remove a significant utilization barrier here. It's hard enough teaching someone how to click versus double-click; throw in a menu system in an incomprehensible language and you might as well give up at anything but the most basic data entry.
For this alone I'll use OO over Office.
And from a helping standpoint, I haven't done much beyond web-based DB-driven apps for a while, but with Ubuntu's relatively painless localization process, I'm trying to help out by doing Mongolian localization for the OS myself.
There are places for everyone to help - it may not be exciting but I figure you should pay it back in somehow.
Firstly is a real word; and according to the Oxford English Dictionary, has been in use ever since 1532. Quotations include "Walke thou fyrstly, walke thou lastly; Walke in the walke that standeth fastly" (1562), "A most delightful [ballad]... which has been laid firstly to Pope and secondly to me" (1723), and "These objects are twofold: firstly, to promote [etc.]" (1857).
Of course, in 1847 the word 'firstly' was accused of being a "ridiculous and most pedantic neologism" (falsely -- being over 300 years old, it was hardly a neologism), and I'll freely admit that it isn't a very *nice* word; but it's a word whether we like it or not.
Tarsnap: Online backups for the truly paranoid
You know that OOo is primarily written in C++, right? Base (the database thingie that appeared in 2.0) and the help system use Java, but that's pretty much it. You don't even need Java installed to run OOo, try it, you probably won't notice the difference.
Game! - Where the stick is mightier than the sword!
Very true, in fact, there are no real words in English that start with an 'f'.
Seriously. Use OpenOffice is like to choose using bus, while having an own brand new and ready to go car.
I saw things like if you're geek, tech and programmer, you're either on Mac with xVM or VmWare (hence you can use better things), or you're on Linux/BSD/Unix and your world is LaTeX, Emacs and other scary-but-very-good-old-school things, because you use X11 for your 20 xterms to open. If you are anybody else, then usually you're on Windows or, again, on Mac, thus you have an ability to use MS Office.
Yes, OO.o software people are downloading, but I think do not use much. E.g. me. I have it. Installed. 3.0 for Mac. Ran twice: first time to see what's new and how it looks like, second time to make sure simple MS Office document gets completely screwed, when opened. MS Office has its own incompatibility problems. But, frankly, much easier to curse Microsoft 1 minute and then use really usable Excel, rather then feel happy 1 minute that you've got software for free, and curse your rest of the day, because Calc can not do most of regular things that Excel does out of the box.
Oh, and that licence thing... That's the last nail into its coffin, IMHO.
But personally, I feel sad for OOo. Nice software (could be). It already has lots of very cool features and could be good competitor. However, I'd stay on iWork and MS Office.
For a long time now, Sun has been pulling a bit of a bait and switch. They claim that they are open source friendly, etc. etc., but then they do everything they can to prevent any outside interference. That's they whole reason why NeoOffice exists, the guys who made it got tired of Sun giving them the run-around.
Gentlemen! You can't fight in here, this is the war room!
I'll let you make up your own mind:
Sun has a history of not playing nicely with other projects, however. A real culture of "not invented here", or just plain arrogance. Makes me wonder what's going to happen to MySQL.
XML is like violence. If it doesn't solve the problem, use more.
Sun requires commits be dual-licensed so that Sun can use the code in the commercial version, Star Office. That's how they control
Digium does the same thing with Asterisk, and that project seems to be advancing nicely.
-- -- Warning. Do not stare directly at the sun.
Haven't you heard? Broadband is capped for many of us. Do you want to have to pay extra to check on that spreadsheet some weekend? I don't.
Besides, broadband isn't the answer for everyone. Availability, security, offline areas, are all concerns for many of us.
Might be YOUR solution, but its not everyones.
---- Booth was a patriot ----
Where I live is surrounded by farms and I'd have to travel 90 minutes either east or west (Albany or Springfield) to get 3G. Rural areas are more likely to be serviced by cable or DSL than have access to 3G, unless they're right next to a large city.
Not a Twitter sockpuppet... but I wish I was.
P.S. In case you think that Bryan Cantrill quote is made up, check it out yourself on Google groups:
XML is like violence. If it doesn't solve the problem, use more.
There are literally thousands of problems with your scenario, and zero with ASCII. Try again.
As long as Sun refuse to take contributions and do meaningful development on O.O of their own, a fork does not make much sense because it would merely duplicate Sun's efforts. In that case, people might just tolerate the status quo.
But if Sun stops development or slows it to a negligible pace, people might get frustrated enough to do something about it. That is what happened with XFree, and today X.org is preferred by most distributions.
C - the footgun of programming languages
Great link. In reading Sun's response I have to wonder, what kind of open source project is worried about "stealing code". There is no stealing code. You contribute to an open source project and then other people work on it. Layer upon layer. I think there may be a culture conflict going on here and Sun and OO is not going to be meaningfully open source as long as long it is under Sun almost exclusively.
Excel is a program that means that you can create shitty models with no proper auditability - which means that people who cannot be bothered to understand databases can think they are being clever (right up till all those quants got their last paychecks during 2008...). Word completely confuses the processes of content creation, editing, proofreading and typesetting, and allows the visually incompetent to waste hours pretending to be proper typesetters on a memo. Powerpoint is...oh, Tufte has said it all, I've paid for his books, you go and do the same and strike a blow for proper presentation of data.
People like MS Office because it enables them to waste lots of time and think they are being productive. Why can I write a 6 page white paper in a morning and it then takes the "customer facing" people a week to pretty it up? Because I was brought up on exercise books and typewriters, and was taught to leave presentation to people with presentation skills.
I use OOo because I need to read the documents produced by these people. But all my models are generated in SQL - usually nowadays in Transact-SQL running on SQL Server, so this is not an anti-MS rant - and my output is in plain text and PDF for things like flowcharts and system diagrams.
Fortunately, as I'm a dinosaur, I can do this stuff in Office and so I'm less likely to suffer a mass extinction event.
From scarped cliff or quarried stone she cries "A thousand types are gone, I care for nothing, no not one."
a document format that I'll be able to use for 10 years, or 20.
ASCII
EBCDIC
I claim first use of "Error No. 0B" - or "No. 0B error." It'll be the new ID 10T!
Yes, because users should learn a programming language to typeset a document.
Leave the basement for a while and take a look around the real world.
"You can either have software quality or you can have pointer arithmetic, but you cannot have both at the same time."
TeX would be an excellent format for a WYSIWYG editor to save in to. It would not be possible with the WYSIWYG to do all of the nice things you can do with TeX, but as long as it saves down to this common, malleable format a broad amount of compatibility is achieved for free. Let the users who want to learn nothing use a simple GUI tool which produces code which can be tweaked by hand, or by other existing tools, when needed.
Why not?
I want my Cowboyneal
As far as I understand it, it isn't just agreeing to a dual-license, but handing over the copyright to Sun. Sun could decide as the copyright owner to ONLY include it in Sun Office, and not include it in the open source versions of OpenOffice.
That being said, there already is a nice fork that Meeks presides over at go-oo.org and several distros use it in place of Sun's OOo right now, and most people don't even seem to realize it.
http://blindscribblings.com - Tasty pop-culture in conceptual fashion.
I'm a C++ developer and I was interested in participating in OOo soon after Sun purchased it.
I joined the project and started participating in the discussion about which GUI toolkit to use. The idea was to start using a common GUI toolkit such as GTK, wxWidgets, SWT, Qt, instead of continuing with the current GUI code which was a mess and was specific to OOo. A lively discussion took place and some consensus emerged, but then behind the scenes it was decided to stick with the existing code.
It seems so obvious to me that using one of the GUI toolkits would have facilitated sharing code and developers with the rest of the open-source community. For example, I wanted to work on the GUI code, but I had no interest in getting involved in this toolkit that was just for OOo, so I abandoned the idea of participating.
The tool you're looking for is called 'LyX'. I've used it for years to edit various people's LaTeX documents, especially those from college professors who learned their craft in the early 1980's and aren't interested in updating their documents.
Kohei wouldn't sign the copyright over to them. Try writing an addition to emacs or gcc and submit it to the FSF without a copyright assignment and you'll get exactly the same response.
Combination - fun iPhone puzzling
This gets modded up as "funny," but cuts close to the truth.
It doesn't matter if you have a clerical staff of five, fifty, or five thousand. The work has to get out the door before the close of business.
You find a desk and chair for the temp and expect her to be productive.
If the "obscure" functionality she needs is integrated into MS Office - and it almost certainly will be - you are halfway home.
The geek is fundamentally a loner.
He'll consider an app "bloated" if it includes anything he doesn't need. That makes it very hard for him to conceptualize anything as amorphous as an office suite.
He can also be afflicted with a kind of tunnel vision.
He'll see Word or Excel but only rarely the MS Office environment - the MS Office system - as a whole.
Resources, third-party apps and so on.
While SharePoint - strictly speaking - wasn't an "Office" app it very quietly generated a billion dollars in sales for Microsoft - and helped strengthen its position.
The central issue seems to be that in addition to being LGPL-licensed, Sun require all contributions to have a Joint Copyright Assignment agreement.
Here's the rub. Kohei *quite clearly* knew about this requirement when he started off. There seems to have been no sign in the interim that Sun would change their stance. Yet he says:-
Long story short, I joined Novell [who] decided to pick me up. When Novell asked me whether I would be willing to change the license of the Solver code to LGPL only, I simply agreed.
Well... why? He already knows that Sun require the JCA before accepting contributions, and that accepting Novell's change would make this impossible unless *they* were willing to change their minds. But then why ask in the first place? Novell's behaviour here is either very cynical or incompetent.
The change in licensing made perfect sense since the entire code was owned by myself (~99%), with a small fraction contributed from Novell and Debian, under LGPL.
Normally I'd agree, but since the code was written for submission to OO.o which only accepts contributions with the JCA, it makes no sense at all.
I'm well aware that some people are going to kneejerk-interpret (and respond to) this post as if it's a blanket defence and/or endorsement of Sun's overall behaviour surrounding OO.o. No, it's not.
What I *am* saying is that whether or not *we* think the JCA is reasonable (and I'm personally dubious about it), Kohei knew that it was required when he started his module and went ahead anyway. Yet he later agreed to Novell's license change knowing (or he should have known) that this would make it impossible to meet those requirements.
Sun might or might not be dicks, and that Summer of Source incident might have been an intentional blow off, but they at least appear to have been consistent and clear on what the terms of acceptance were. Seems Kohei knew this when he started but later agreed to an incompatible license change anyway. His choice, but I've no idea why and I don't see how he can complain about this.
"Slashdot - News and Chat Sites Deviant". (Click "homepage" link above for details).
Sun is Big Daddy Warbucks, your prime source for funding.
Full-time management. Full-time development.
The geek - the volunteer developer - sees everything as code.
If the problem is not in the code he is fucked.
Microsoft can afford to employ experts in office management, workflow and training, psychologists, physicians...
Experts in layout and design.
Typography.
If his GUI is - to the uninitiated - as unintelligible and crippled as The GIMP is alleged to be, the problem can't be fixed.
Well, they are competing against Microsoft Office. You have to understand your competition.
Back when ebcdic was relevant, the basic encoding of characters wasn't a mature technology. Now it is. ASCII will be in use as the lowest common denominator for a long time, if only as a subset of utf.
Go ahead and rely on ascii for your word processing needs. Vim is heavy-weight enough as it is -- no sense weighing down your whole machine with something gargantuan like ooo or emacs.
EBCDIC is still alive! Probably will still be alive in 10-20 years.
"If anything can go wrong, it will." - Murphy
Open office exports to TeX
It's not evil that matters. It's indifference. They're ad brokers. That means you're the product, not the customer. That means they're not accountantable to you. It doesn't matter if they satisfy you as long as they satisfy enough people in their target markets. Don't trust Google for anything that matters.
I'm of no relation to the OP, but simply from my own frustrating experience of trying to slog through their API documentation, I'd have to agree with the overall point that Sun has done no one any favours when it comes to clarity.
Say, for example, that you're trying to whip up a simple script to munge some text in a Writer document. After considerable reading around, you might discover that you need an object of type TextCursor to work with Writer text. So you dig into the API docs to try to find out what properties and methods a TextCursor object has.
Please, read the TextCursor API page linked above, and then see if you can quickly understand what properties and methods a TextCursor object has.
If the OOo source code and related documentation are at all similar to the API documentation, then I must say that I'm frankly flabbergasted that the project has made any progress at all.
Cheers,
"What in the name of Fats Waller is that?"
"A four-foot prune."
You are a perfect example of why I don't take OO.o seriously. Look at your wording. "office slaves", "suits" Blah, blah, blah. Because only "secretaries" actually do trivial stuff like writing or analysis, while you're a (woo-hoo!) ENGINEER with your manly coding skills. As if you are somehow proving how superior you are in your contempt for, y'know, the actual intended users of the product.
I don't eat food by cooks who have contempt for what those eating it will taste. I don't wear clothes by people who have contempt for how their products will fit. I don't read books by writers who have contempt for their reading public. And ya know what? I've dealt with programmers from inside Adobe and DEC and HP and Apple and, yes, Microsoft who bloody well *loved* the tiny, "mundane" little problem they were spending years on. How can we get this line screen algorithm to better deal with heavier paper stock? How can we change this header to be more fault-tolerant for people using degraded documents? And so on. And you can see that love in the quality of their work.
If you hold the users of a feature in contempt then, frankly, I think that you should get the fuck off that part of the project. Because chances are your code will suck and it will look like the feature or bug has been addressed when, in reality, it has just morphed into a new problem.
It's all about the information. And what we do with it.
More or less, exactly what you pointed out :) -- you have to jump around through several different pages, sometimes branching through whole trees, to find out the properties and methods of one single object type. This is not easily discoverable. Sure, it's possible to find things out, but it's certainly not terribly easy nor fast. From a source code point of view, I can understand the reasons for listing which interfaces are implemented, but from an API perspective, why not include also the methods and properties themselves, all on the one page? That's easy enough to do with proper referencing and no need to duplicate content on the server, and keeps the reader from having to jump through so many hoops.
And, as you yourself note, in some cases the documentation doesn't even document things properly:
So again, it's possible, but neither easy nor fast. When I'm trying to get myself up to speed with either an API or a bunch of source code, the last thing I want to be doing is wasting time and energy due to poor organization of the docs.
In contrast to the maze of twisty passages that is the OOo documentation, let's look at Microsoft's documentation for the Selection object for MS Word, roughly similar in some ways to Writer's TextCursor. Here, we have all properties and methods listed on one page, with no need to click and click just to find the names of what properties and methods a Selection object has. As much as I quite dislike MS for how they conduct business, their documentation puts just about any FOSS project, and certainly OOo, to shame.
Cheers,
"What in the name of Fats Waller is that?"
"A four-foot prune."