[Phpmyadmin-devel] Documentation

[Michal Čihař]

Hi

for quite some time I was thinking about way we provide documentation
and I think there is lot of place for improvements.

As my current favorite tool to build documentation is Sphinx
<http://sphinx.pocoo.org/>, I gave it a try. To name some of the
benefits let me quote from their home page:

* Output formats: HTML (including Windows HTML Help), LaTeX (for
   printable PDF versions), manual pages, plain text 
* Extensive cross-references: semantic markup and automatic links for
  functions, classes, citations, glossary terms and similar pieces of
  information 
* Hierarchical structure: easy definition of a document
  tree, with automatic links to siblings, parents and children
* Automatic indices: general index as well as a module index
* Built-in fulltext search

I've done quick and dirty [*] conversion of FAQ and few introductory
sections, you can find source here:

	https://github.com/nijel/phpmyadmin-doc

And the generated documentation in HTML and PDF here:

	http://tmp.cihar.com/pmadoc/index.html

	http://tmp.cihar.com/phpMyAdmin.pdf

What do you think about changing our documentation from HTML to
something else (be it Sphinx, Docbook or something completely else)?

[*] I've lost all text formatting and links in text, but that should
not be hard to convert properly, I just did not want to spend much time
on prototype.

-- 
	Michal Čihař | http://cihar.com | http://phpmyadmin.cz
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: not available
URL: <http://lists.phpmyadmin.net/pipermail/developers/attachments/20120926/bf98ee23/attachment.sig>