On Feb 7, 2008, at 14:38 , Will Scheidegger wrote:
Hi again
I noticed that I don't have your Mail address. So: Sorry for
abusing this list. My JIRA username is "will" (what a coincidence).
Thanks for giving me write permissions on the wiki.
no prob. done.
gregory_dot_joseph_at_magnolia_dot_info, if ever.
Again: Please let me know if we can help in any additional ways
than just trying to structure the Wiki. I'll have a look at the
pages and will post a structure proposal to the list _before_ I
start messing around. But don't expect this to happen in the next 5
days since we're moving our office to a new location on monday :-/
Sure, no prob. That's the point of a wiki... you do what you can,
when you can... if only we didn't have the license issue.
On 07.02.2008, at 14:28, Grégory Joseph wrote:
Will,
In the new wiki you can *actually* have that structure by changing
a page's parent. You don't have to maintain some fake table of
contents anymore. We also started *tagging* some pages with
version number or other tags, which is another interesting to find
stuff out. The search engine is probably considerably better than
the old one too.
So yeah, feel free to move pages around like you suggest, that'd
be great.
Also, the new wiki has a nice rss feed builder, which should help
everyone keeping up-to-date with what's going on on the wiki, in
their specific fields of interest or on the whole site :)
FYI, API docs are now published here:
http://dev.magnolia.info/ref/latest/apidocs/index.html
This wasn't said before just because it will be linked from the
new docu website, but as this is being later than originally
thought, well, here goes.
-g
On Feb 7, 2008, at 14:12 , Will Scheidegger wrote:
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
----------------------------------------------------------------
----------------------------------------------------------------
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
----------------------------------------------------------------
