-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Okay. As promised, I looked at it.

As mentioned previously, I found the issues Jesse found.

And I have good news, and I have bad news:

Good news (I'm a good news first kind of person): I have a site built
for 3.0.4. Not sure how to send it or to whom, but I have it. See below
for details/changes.

Bad news: After about 5 pages of "here's what I had to do to build it",
and then manually copying changes.html from 3.0.3 and making
modifications directly to that (normally generated) file, I must say
that the 3.X documentation is completely unreproducible from anything
considered to be simple instructions. (One of those "hold your left hand
here and raise your right foot" kind of things)

That said, here's what I did:

Updated the status section of the index page.

I modified the nav on the left to remove TODO, and What's new - these
were outdated (even as of 3.0.3)

I removed the link to the tutorial from within the Component Reference
(it was a "see also" at the bottom of the index page) as it too was
outdated. There's still a link to the external tutorial.

And as I said, I manually copied changes.html (no, status.xml wasn't
being generated into changes.html/changes.rss for me no matter what I
tried). I made the same nav changes, added the issues for 3.0.4, and
removed the RSS link. Could have left it, but modifying one generated
file was bad enough.

So there it is.

For any further 3.X releases (and I'm personally only looking at
resolving all further issues - nothing 'new and exciting'), I see the
following possibilities for the site:

1. Don't worry about the documentation
2. Do what I did this time. (and that would actually mean me doing it
unless someone else has an old 3.X build area laying around)
3. Re-work how the documentation is built.

I see (1) as unacceptable - if there's a release, there's documentation/site
I see (3) as too much effort for finishing up support of an old branch.
If I have that much time on my hands, I will probably look at it, but I
wouldn't commit to anything here.
Which leaves (2) as my personal view as a preferred course. Of course, I
do have a few files to check in in order for what I've got so far to be
somewhat reproducible (the changes.html, an index.xml - have numerous
other changes but they're specific to my directory structure... would
rather leave these out)

Thoughts? Method of getting this out to someone to look at? Valium? I'm
open for anything at this point. :-)

Brian
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.5 (MingW32)

iD8DBQFENBl6aCoPKRow/gARAu8YAKCYen9LOk+d8vdK6QKzQHP2eLB0kACdEdel
qwwq/HbGQsfSiopsnAeTtJk=
=Xdye
-----END PGP SIGNATURE-----

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to