[Phpmyadmin-devel] Single point for developers

Hi all currently our documentation for upcoming developers is spread over different places: [1] FAQ 7.3 in Documentation [2] Developers section in Documentation [3] http://www.phpmyadmin.net/home_page/devel.php [4] wiki What I'd like to do is to move most information to website [3], with possible more detailed information on wiki [4] and removing almost all content from Documentation [1],[2]. Currently it is quite hard to keep the information up to date [*] and I don't think it makes much sense to provide information in the documentation for offline usage as you would anyway require to be online to contribute. I've just submitted pull request for this change on github, so feel free to comment it there: https://github.com/phpmyadmin/phpmyadmin/pull/1 [*]: I think that [2] will become really outdated on our way to 4.0. -- Michal Čihař | http://cihar.com | http://blog.cihar.com

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Le 2012-02-13 07:58, Michal ?iha? a écrit :
Hi all
currently our documentation for upcoming developers is spread over different places:
[1] FAQ 7.3 in Documentation [2] Developers section in Documentation [3] http://www.phpmyadmin.net/home_page/devel.php [4] wiki
What I'd like to do is to move most information to website [3], with possible more detailed information on wiki [4] and removing almost all content from Documentation [1],[2].
Good idea, but why not put most information on the wiki? Maybe more static info should go to website and more dynamic one, to the wiki?
Currently it is quite hard to keep the information up to date [*] and I don't think it makes much sense to provide information in the documentation for offline usage as you would anyway require to be online to contribute.
I've just submitted pull request for this change on github, so feel free to comment it there:
https://github.com/phpmyadmin/phpmyadmin/pull/1
[*]: I think that [2] will become really outdated on our way to 4.0.
- -- Marc Delisle http://infomarc.info -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.17 (MingW32) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iQIcBAEBAgAGBQJPOSTxAAoJEP78ZdGBr2RKWeQP/0sJHyY2AIrDUM2vaQIQ8vF8 w8cvcPCd1Mawy4wP84x11XVntN+WUi9I38BIs176C5WOytjyGzc5yljoJEzibF5y Lgh4KtoUK+MPARqaY4J2J0Lzp6S1RJuHtxLvDzPajY4+qIViJlYH8HQUHmDMGXRH 7HADhdKZRQ1lom4a1EWdFwIIahVCD00rwEF3Jzu1p/RVKEwZVBP2HcTy7HtZhK4c gZlTitxpzG7PEaY5kk2lDX1lpFHMphmyr9cpPXRLxq9jYEcNxJWbPttUzzlez033 vGJpJmUBjMP8Y2GUSJtwXh7v+gHnBDmjrzP0fclVHsOi5S0gT9ATrxr1Y5n35PBS n0ig3Jb7TEoAQTiEq8/Sm3lB689bdyY5HqqWYN7oSaRQ1T0PKsd3aFKC+2/YIgrq CrnNa3s84ARwsT5X8dP6I55Tx0JJH9aDaX2X0JvV0hgrlnTAAkKB/Dxft0x0l8qL wwndvWUzHZh3JfzCQgHtZZ4PCQB5zV3ExO+xZFd3x5itDMGap8kpu+juZXFBNeZN PeCGQcEsHqR1qeNZvqxF4PILjB4LSagPjowr50L/S56HWssVWbm1KQrhX3BiVswg edBF1ODrp5rgXS1tKL3+6rk2qvBGTP0DkDR0u+BGO2R4J1N0WDbYtrR10Lh5uO4l a+L42Qf8gBH5NXcooCaP =zhNn -----END PGP SIGNATURE-----

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 Hi Dne Mon, 13 Feb 2012 09:57:54 -0500 Marc Delisle <marc@infomarc.info> napsal(a):
Good idea, but why not put most information on the wiki? Maybe more static info should go to website and more dynamic one, to the wiki?
Well I don't think website should contain more information than it currently does. Rest should be put into wiki (I've put there all what was included in documentation for now). - -- Michal Čihař | http://cihar.com | http://blog.cihar.com -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.18 (GNU/Linux) iQIcBAEBCAAGBQJPOSXpAAoJEGo39bHX+xdNsK0P/ju+CM/AU7hQX15PTtEohUSW SS5Uma6YJJIvm1QiXSCBOiaBRaK8qNu1tYNypsz82xY/tHDvScs/RqDrEOw6M2jI AshqGM6qfVrKDvnRxXV8YJCIEtvv3xQ+z9krvyP6zzhB71pz6MbfqHuVpmeVNvRY 0PnbFRHelPejTLjhypHz0xypbylxECyV1gwCQfQpQ4cZlCWsejObNrP/sQfDCq53 o/RlkDosBi8llpxxoLHgUb3MiDR35Dw1TwUAxM7dKpdRl8sjRTw0MP+Od/D8r5rL B4/iUxgsr/xCQMwN1s4J0vNVR0beKJIYyBAOsJVgjrwcGZVAF1Fp8NPWKaXbyza2 bE82U1VgN9ie3a1cGbhsbEgG6UfcjqY6Sy4NQIKjGL/I5JKgHPYcyHwWSuyOannw nbviFtAbornfEGv31kfX4I7GtofYePHjJp0XFGiyqIiZBdRUpVY/8CBKCYBfYc6d +2FGts/VZ3nFV+lWz+rUuDWrEpShD1JmrRkaadsoAkCf6lGEieSvdad553Qv610D 5+KbKAS8Nhne0XE74nBHBbTxNJ2AIczCIUAitPk0vLt6sncn0J84kIFWzHZwgjvC MmByZlkADgT60MSPhM8IpymDrNj0vAg/2YJ/HH8jQ7rYSyYL/pfrWylluhLIbue5 irb4To/XJbnvXkavtXoH =17wu -----END PGP SIGNATURE-----

On 13/02/2012 16:01, Michal Čihař wrote:
Hi
Dne Mon, 13 Feb 2012 09:57:54 -0500 Marc Delisle <marc@infomarc.info> napsal(a):
Good idea, but why not put most information on the wiki? Maybe more static info should go to website and more dynamic one, to the wiki?
Well I don't think website should contain more information than it currently does. Rest should be put into wiki (I've put there all what was included in documentation for now).
Hi, The website (devel/contribute page) is an entry point for new developers and should point to the wiki for detailed (and up to date) information. Kind regards, Dieter
participants (3)
-
Dieter Adriaenssens
-
Marc Delisle
-
Michal Čihař