Author Topic: Zentyal doc for advanced users [planning]  (Read 6141 times)

mburillo

  • Zentyal Staff
  • Zen Apprentice
  • *****
  • Posts: 43
  • Karma: +4/-0
    • View Profile
Zentyal doc for advanced users [planning]
« on: April 20, 2012, 07:58:06 pm »
Hello everyone,

In our last Zentyal Community Council, we discussed about the need of some "advanced user" documentation. This documents and how-tos are supposed to fill the existing gap between the current Zentyal doc (kind of cookbook, easy-to-follow step-by-step GUI guide) and the development guides (how to develop new Zentyal modules using perl and Zentyal framework).
The target person is someone used to hack his way around using the CLI, that wants to go a couple
of steps beyond what is possible using only the web interface.

Based on the most frequent requests and what we consider interesting for this target public,
we have put together the following list:

- Troubleshooting and debugging Zentyal, main log files for Zentyal and each one of the services, how to reproduce and catch the errors on the fly, verbose description.
- How to integrate third party applications with Zentyal's LDAP (moodle, openerp, subsonic, whatever...)
- How to adjust the service templates to modify the translation between the web GUI and the resulting
configuration files in a permanent fashion.
- Proper partitioning, RAID0, RAID1 and RAID5 and LVM, how to do it, why and when to do it and good
practices.
- Possible documentation appendix covering /etc/zentyal parameters, description, justification and possible tweaks.

We really think this will make a great difference  :D. Are you missing any other topic? Would you like to contribute with some howto?

Regards,
Zentyal Staff - Product Manager

christian

  • Guest
Re: Zentyal doc for advanced users [planning]
« Reply #1 on: April 21, 2012, 12:34:35 pm »
Excellent news  :)
I'll try to provide some inputs here later.

jsalamero

  • Zentyal Staff
  • Zen Hero
  • *****
  • Posts: 1419
  • Karma: +45/-1
    • View Profile
Re: Zentyal doc for advanced users [planning]
« Reply #2 on: April 22, 2012, 09:20:01 pm »
Über cool!! I think those points are a very good choice for starting with the advanced documentation :)

Escorpiom

  • Zen Hero
  • *****
  • Posts: 897
  • Karma: +25/-1
    • View Profile
Re: Zentyal doc for advanced users [planning]
« Reply #3 on: April 23, 2012, 06:49:19 am »
That would be a good step forward, it will be useful for people like myself, with only some basic understanding of Zentyal.

Cheers.
Marcus' Rule:
Blanks & capitals = avoid it and you'll avoid problems...

robb

  • Guest
Re: Zentyal doc for advanced users [planning]
« Reply #4 on: April 23, 2012, 09:51:15 am »
It would be even more cool when a few 'advanced' community members get together to do this project. When community documentation team meets the Zentyal documentation team, we will get best of both worlds...

majestyx

  • Board Moderator
  • Zen Warrior
  • *****
  • Posts: 243
  • Karma: +8/-1
  • Dont feed the Troll !
    • View Profile
    • German FSFE Blog
Re: Zentyal doc for advanced users [planning]
« Reply #5 on: April 23, 2012, 11:55:54 am »
thumb up !!!  8)
Ahoi
Michael (majestyx) pls, applaud if I could help ;)
--
Erst lesen, dann schreiben: http://forum.zentyal.org/index.php/topic,4317.0.html

Zentyal Doku: http://doc.zentyal.org/en/zindex.html (engl.)

juanmarquez

  • Zen Apprentice
  • *
  • Posts: 6
  • Karma: +0/-0
    • View Profile
Re: Zentyal doc for advanced users [planning]
« Reply #6 on: April 30, 2012, 06:37:05 pm »
Ale lu ya. Congratulation for good intention

mburillo

  • Zentyal Staff
  • Zen Apprentice
  • *****
  • Posts: 43
  • Karma: +4/-0
    • View Profile
Re: Zentyal doc for advanced users [planning]
« Reply #7 on: May 10, 2012, 01:13:36 pm »
Ok, apparently the list has had good reception, very good  :). Unless someone complains the next few days, we can consider it closed and start the real work  :D

Thanks for your feedback everyone!
Zentyal Staff - Product Manager

linuxmaniac

  • Zen Apprentice
  • *
  • Posts: 24
  • Karma: +0/-0
  • Death is just beginning..
    • View Profile
Re: Zentyal doc for advanced users [planning]
« Reply #8 on: May 14, 2012, 03:27:45 pm »
That's good news.
An API list or code structure/hierarchy would be great.

Cheers.

mburillo

  • Zentyal Staff
  • Zen Apprentice
  • *****
  • Posts: 43
  • Karma: +4/-0
    • View Profile
Re: Zentyal doc for advanced users [planning]
« Reply #9 on: July 12, 2012, 07:53:45 pm »
Hello everyone,

A first draft of

- Possible documentation appendix covering /etc/zentyal parameters, description, justification and possible tweaks.

is already available at:

http://trac.zentyal.org/wiki/Documentation/Community/Advanced/MainFiles

Still needs some polishing and some details, but could be a starting point. What do you think? Should we continue the effort
together  ;)?

Regards,
Zentyal Staff - Product Manager

robb

  • Guest
Re: Zentyal doc for advanced users [planning]
« Reply #10 on: July 12, 2012, 11:52:33 pm »
Thanks a lot for the effort Matteo....
Good idea... lets's pick it up together with the community from here...

Escorpiom

  • Zen Hero
  • *****
  • Posts: 897
  • Karma: +25/-1
    • View Profile
Re: Zentyal doc for advanced users [planning]
« Reply #11 on: July 13, 2012, 08:29:39 am »
Yes please! This was the part that we needed, I just took a peek and there are a lot of things I didn't know about.
Very nice.

Cheers.
Marcus' Rule:
Blanks & capitals = avoid it and you'll avoid problems...

ian

  • Community Council Member
  • Zen Samurai
  • *****
  • Posts: 296
  • Karma: +10/-1
    • View Profile
    • Familie site
Re: Zentyal doc for advanced users [planning]
« Reply #12 on: July 13, 2012, 11:08:58 am »
Hello,

This is already a very good start.
Maybe it is also good to document the configuration scripts ( backup and restore scripts of the defined users groups shares computer accounts etc ).

Thanks for the effort.

Best regards,
Ian

zahadom

  • Zen Apprentice
  • *
  • Posts: 22
  • Karma: +3/-0
    • View Profile
Re: Zentyal doc for advanced users [planning]
« Reply #13 on: July 13, 2012, 04:51:29 pm »
This is a very good idea!!
Is a great information!!!
If I can provide some information, for sure I will. I am currently trying to set up Jabber for publishing LDAP groups, and not have to search users.

linuxmaniac

  • Zen Apprentice
  • *
  • Posts: 24
  • Karma: +0/-0
  • Death is just beginning..
    • View Profile
Re: Zentyal doc for advanced users [planning]
« Reply #14 on: July 14, 2012, 08:52:54 am »
That's a walk on the right path mates.
Cheers.