Hi Greg
Thanks for the reply. I'm a bit less worried as before ;-)
I'll ping you with my JIRA UN and will probably start with
documenting what I have learned so far about the data module.
Still, would it be possible to structure the WIKI a bit? e.g.
- Mag 2.x
- Mag 3.0.x
- Mag 3.5.x
- Configuration
- Templating Tricks & Tips
- Other...
- ...big...
- topics.
The last WIKI did have some structure to it.
Regards,
Will
On 07.02.2008, at 14:01, Grégory Joseph wrote:
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
----------------------------------------------------------------
----------------------------------------------------------------
for list details see
http://documentation.magnolia.info/docs/en/editor/stayupdated.html
----------------------------------------------------------------
