Am 11.12.2005 um 19:38 schrieb Henri Bergius:
On Dec 11, 2005, at 20:26, Sonic wrote:
Hi!
Greetings!
As to your question: I found that the only relatively reliable way
to work with Midgard's documentation is to use Google Search to
navigate and google cache to display the actual pages. After weeks
of getting random login prompts, timeouts, empty pages and 404
errors, I had to resort to this method and found that while it is
not really comfortable, it is at least reliable and turns up more
information than navigating the site directly.
This was mainly due to MidCOM search tool pointing the links to
https instead of http. This was fixed
last week.
Yeah, I know (and I reported this error two weeks ago, BTW), but like
I said, timeouts for example occur randomly (maybe I'm just too
impatient, but after 30 seconds, I usually give up). As for broken
links, sure I can report them when I stumble across them, but I think
some automated test would be far simpler and more reliable. As for
empty pages, ok, next time I spot one, I'll post it to the list.
If you find any other pieces of docs that are not working, please
let me know.
What is partly usable is http://www.midgard-project.org/api-docs/
midcom/stable/ (although I have to laugh every time I read
"welcome to undocumented!" on the start page. This should be the
motto for all Midgard dcumentation :-).
Yep. "midcom" would be a much more sensible default module to end
up. The current PhpDoc setup
could use some tuning.
FWIW, I've summed up some of my findings here: http://
midgardwiki.contentcontrol-berlin.de I'm fairly sure that half of
it is completely wrong or at least inaccurate, but hey, maybe it
can provide a few clues.
BTW, now that we have wiki software running for Midgard's
documentation area, it would be great to
start merging stuff in from your wiki. What do you think?
Well, mine is more like a notepad and should certainly be reviewed
before any inclusion, but I'm not against doing it (It's all freely
available). I myself can't do any merging as I unfortunately don't
have my login password to the site any longer (hard disk crash). I
mailed you off-list twice about it, but so far haven't heard back...
Bye,
Andreas
BTW: I just browsed through the documentation a bit and it seems to
have improved quite a bit in terms of navigation over the past few
days, kudos to whoever was working on it!
One suggestion though: Could the menu on the right side be made a bit
more useful? Only the same three links on all pages doesn't really
help you navgiating. The old documentation for example had those
expanding menus which IMHO where quite helpful. It would be kind of
nice to have something similar here.
Some docs on how the Midgard wiki works:
http://www.midgard-project.org/documentation/how-to-contribute-
documentation/
Andreas
/Henr
Henri Bergius
Consultant Partner, Nemein
[EMAIL PROTECTED]
Midgard CMS
www.midgard-project.org
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Adding sound to movies would be like putting lipstick on the Venus de
Milo.
--Mary Pickford, 1925
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
