Will,
Thanks for the email.
A quick reply:
- we're actually working on a new documentation site which will be
hopefully be better managed than the current one, and improved on
more regularly. We realized a while ago our documentation was
terrible, but as you certainly now, we are a very small team, so this
always slipped under pressure of larger projects.
- the new wiki is not messier than the previous, since said previous
one had no structure at all either. Maybe the mess there was just
less *visible*. As you have noted, we're waiting for a license issue
to be resolved, so in the meantime I can only add permissions to
specific users. Ping me with your Jira username and I'll be glad to
add you.
- what exactly is your issue with the ACLs for URLs ? Nothing has
been "completely modified", the only thing that changed afaik is the
fact that we moved (un)securedURIs configuration to full blown ACLs
for URLs. We don't always have time to reply to all user-list emails,
so your questions might have been left unanswered, and I'm sorry for
that, however I don't believe this specific feature is a reason for
being worried; it should only make your life easier, esp. if you use
roles and groups.
As for your questions, I can't promise immediate reactions if you
contact me privately. The users list should be a good place for this,
but as I've said before, we can't always follow up at the moment
either. You can also find some of us, sometimes, on irc.freenode.net
at #magnolia.
The best would probably be to use the wiki. With your approval, we
could then lift content out of it and in the proper documentation site.
Thanks for the positive and constructive remarks. Your help is much
appreciated.
Cheers,
-greg
On Feb 7, 2008, at 13:40 , Will Scheidegger wrote:
Dear Magnolians
Am I the only one that is a bit worried about the state of Magnolia?
While the development work that we see is fabulous, the
documentation lags _far_ behind.
- Did you know, that a new tag library was introduced with Magnolia
3.5? I'm sure it does slick things, but we will never find out
about them unless we trip over them by accident.
- By know you probably have heard, that the access control to pages/
URLs has bin completely modified in 3.5 - but do you know how
things really work?
- When you visit documentation.magnolia.info it tells you that the
current release is 3.0, also the API linked there is the one from
3.0. The last update seems to be from May 25th.
- The new Wiki is a mess. It has no structure at all so it is
nearly impossible to browse through articles to find out what is
documented and what not. On top of that "hopefully we receive a
license in the next week" has been greeting us from the front page
for a month now.
MY GOAL IS NOT BASHING THE MAGNOLIA TEAM. As I said: They are doing
a terrific job developing Magnolia. I just wanted to emphasize that
not investing in documentation will not help at all in the long run.
As I said before on- and off-list: I am more than happy to help
documenting things. But I would need the following before I get
started:
- Specific task: What should I document, what is taken care of by
others?
- Contact: Who can I contact when I have questions?
- Place + access: Where should I document + how? Wiki,
documentation.magnolia.info, other?
The Magnolia developer have delivered the basis for blowing away
other CMS - if we don't deliver the missing documentation to it,
the world will not be able to honor the hard work of the developers!
Amen!
And now... back to work.
Cheers,
Will
----------------------------------------------------------------
for list details see
http://documentation.magnolia.info/docs/en/editor/stayupdated.html
----------------------------------------------------------------
----------------------------------------------------------------
for list details see
http://documentation.magnolia.info/docs/en/editor/stayupdated.html
----------------------------------------------------------------
