I don't know what Scott thinks of all this
I think any substitute for or variation on the current approach must:
- Be WYSIWIG editable, more or less, at least in the OSX app
I think a another OSX WYSIWIG html edtitor would be ok. It might save
the trouble trying to recode apple's editor.
- Render consistently in major engines.
- Not be in any way worse than the current situation.
- Have someone willing to convert and maintain it. Half converted
and/or abandoned approaches won't do.
The last is the monster job, and so far nobody has been willing.
Well its not the same as (re) writing them.
Here's a hypthetical scenario:
** someone manages to restrict the OSX editor (or another one) to
somewhere between 5 and 9 divs, 5 <h> levels, links, images, tables,
bold and italic, and <pre>or <code>. No apple tabs and apple spaces
** All of these automatically have the syntax: <TAG
** The divs do the paragraph indentation, the <h> levels the titles.
** All these can be accessed by key command or a quick menu or
** Anything in <code> would be automatically syntax colorized.
Then you could easily manually reformat 10-20 help files in an
I recently completely *revised* about 50 of them. That was a big job,
since the longest ones took two full days (there were only a couple,
like View and Document), and usually I could do 2-3 per day. Some
be written from scratch. Some involved designing code examples, etc. .
Reformatting an already correctly formatted file, is not that tedious.
Reformatting a badly formatted file takes time. Doing a new help
revising one to fit in a Helper template is a lot of work. So there
needs to be a mixed approach if something like this is done. We cannot
redo all of the help files as far as content goes. A simple
scheme is doable.
It also might be possible to write script which would do 90% of the
reformatting, and only need to be corrected a bit. That would really
The help files would look *exactly* like the current templates. And
could have a dirt simple syntax where you can even read svn diffs
Wrong formatting and double spacing would be completely eliminated.
So then the question is, how many help files are there, and how hard
it to adjust the OSX editor.