What Documentation / Tutorials would you like to see?

Quote from: splittingred at Mar 19, 2010, 04:59 PM

Quote from: einsteinsboi at Mar 19, 2010, 04:57 PM

Signed a CLA but haven’t had time to fax it in... have to go to Fedex since I don’t have a fax at home, and I don’t have stamps... darn I sound a little pathetic... lol

Do you have a scanner? We take scanned CLAs.

Yes I do. Will email it directly to you. thanks!

Quote from: splittingred at Mar 19, 2010, 04:46 PM

By the way, if someone has signed a CLA and either:
a) developed a relationship with the MODx team
b) written good documentation in the ADDON space

I like the "default" /addons/ idea. A simple list of the add-on names which would then lead to a little mini website -- would be cool, that way we would no longer need to "search" as links to these forums or where ever could simply be placed there.

I believe I have access already, but want to make sure I know what I am talking about before editing / adding things there. Today’s project, for example, was to create a snippeted version of the xPDO20/xPDOGenerator.writeSchema. I create almost all of my tables via Mysql Workbench, as many people do, so having a snippet I can run to quickly create the schema will prove beneficial at the least.

Even though some of the progressive thought now entering the package manager: such as prepackaged sites, provisioner, etc. I can easily see where MODx could get into more user centric areas.

But, I am a developer, and I prefer a platform that stays out of my way, while giving me the resources necessary to complete my projects. MODx provides exactly that ability.

The fact that you can build your own xPDO implementation to extend MODx into what ever application you would want should be instrumental in people building some very impressive systems.

Quote from: TomMLS at Mar 24, 2010, 09:30 AM

I have not read this entire thread. It IS developer-heavy, MODx might become a developer-only app.

The MODx core, ideally, would be developer-centric. Those developers, then, would develop Extras/packages/distributions that are more user-friendly. Even Drupal has this model with it’s core.

d7ux.org is absolutely on the right track...especially in their user ’personas’ use cases.
MODx would be missing the boat if it does not even try even a little bit to follow in Drupal’s footsteps.

We are always open to UI improvements and/or suggestions.

How many of you have looked at Drupal Gardens?? It is in beta and it is already the future of site development for many people...I would be recommending it for where I work if it was more feature-complete (more customization, events calendar, document management, SEO, etc.)...but I am keeping a close eye on it...later this year, hopefully.

Eh, it’s a specialized system that certain people will like, and a lot of others wont.


All that said, we will definitely be improving the documentation, and separating end-user docs from developer docs more and more. Priority was to get RC-1 out.

I would love a tutorial on how to setup users in the new version of Revo (best practice).

Scenario:

I have a website which accepts user submissions. When a user has submitted an article, it is done so through a simple web form to my email, so I (the admin) create the page.

I want to allow the user (who i create in modx) to be able to login and edit that one page specifically and not be able to see any other pages.

Cheers
André

I’ll second Andre and make it more general: I’d like to see brief descriptions of and for best practices (or at least how the core team imagines things being done) for user management, content organization, path aliasing, contexts, and pretty much anything in Revo that provides the freedom to do things sub-optimally with no clear recommendations.

I’d also like to see a tutorial on extending the interface, not just to create new panels, but to do things like add codemirror http://marijn.haverbeke.nl/codemirror/ to the built-in file editor through extJS.

Also, I’d like to now how to add custom RTE, looking through the result of installing TinyMCE is educational but also somewhat confusing, it would be nice to see a bare-minimum, zero configuration, example of ’put javascript in this directory, create these php files, put them here, register the plugin with MODx this way, etc.’ Either that or a codemirror RTE

Only my second post so forgive me if I’m not aware of a lot of background to this, but I would have thought that a tutorial on porting an existing site into modx would both attract a large audience and help to increase your user base.

All the slick stuff is all well and good - but many people just want (for example) to get an existing site into a cms/cmf so as to enable the client to update content themselves. I know there are simpler cms’s if that’s all you want to do - but it would encourage people to make the transition...

Quote from: nsfdev at May 08, 2010, 12:47 AM

I’ll second Andre and make it more general: I’d like to see brief descriptions of and for best practices (or at least how the core team imagines things being done) for user management, content organization, path aliasing, contexts, and pretty much anything in Revo that provides the freedom to do things sub-optimally with no clear recommendations.

Case Studies are a far better path for this - there’s no way to write solid documentation in competely abstract, generic terms. If you’d like to propose some Case Studies, we’d definitely embark on that.

I’d also like to see a tutorial on extending the interface, not just to create new panels, but to do things like add codemirror http://marijn.haverbeke.nl/codemirror/ to the built-in file editor through extJS.

That’s a bit more complex, but I need to iron that out. I’ll look into it.

Also, I’d like to now how to add custom RTE, looking through the result of installing TinyMCE is educational but also somewhat confusing, it would be nice to see a bare-minimum, zero configuration, example of ’put javascript in this directory, create these php files, put them here, register the plugin with MODx this way, etc.’ Either that or a codemirror RTE

Well, since each RTE is completely different in how they integrate, that’s not really that easy. Once we standardize the hooks, however, we’ll get something up.

http://modxcms.com/forums/index.php?topic=39210.0

venu wrote

hello
can anyone help me to create multi lang sites with revo
i understand a bit it can be acheived in 3 ways(conexts folder,virtual host etc..)
but if anyone tell us what is the best way to do this
and the steps we have to do that will be helpful

actually i haven’t seen a clear way yet, as well. i get the abstract idea of contexts, but can’t yet figure out how to make them work as language-switch (with subfolder-structure /de )

Hi,

Now when we have revo GA, I would like to see a document on how to build and package custom revo distribution.

Thanks
S